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LIMITED WARRANTY 


CUSTOMER OBLIGATIONS 


A. 


CUSTOMER assumes full responsibility that this computer hardware purchased (the ‘Equipment ). and any copies of software 
included with the Equipment or licensed separately (the Software”) meets the specifications. capacity. capabilities. versatility. and 
other requirements of CUSTOMER 

CUSTOMER assumes full responsibility for the condition and effectiveness of the operating environment in which the Equipment and 
Software are to function. and for its installation. 


RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE 


A 


For a period of ninety (90) calendar days from the date of the Radio Shack sales document received upon purchase of the Equipment. 
RADIO SHACK warrants to the original CUSTOMER that the Equipment and the medium upon which the Software is stored 1s free from 
panuiaclucing detecis. This warranty is only applicable to purchases of Radio Shack and Tandy Equipment by the original customer 
from Radio Shack company-owned computer centers, retail stores and from Radio Shack franchisees and dealers at its authorized 
location. The warranty is void if the Equipment’s case or cabinet has been opened. or if the Equipment or Software has been subjected 
to improper or abnormal use. If a manufacturing defect is discovered during the stated warranty period. the detective Equipment must 
be returned to a Radio Shack Computer Center, a Radio Shack retail store. participating Radio Shack franchisee or Radio Shack dealer 
tor repair. along with a copy of the sales document or lease agreement. The original CUSTOMER'S sole and exclusive remedy in the 
event of a defect is limited to the correction of the defect by repair. replacement. or refund of the purchase price. at RADIO SHACK S 
election and sole expense. RADIO SHACK has no obligation to replace or repair expendable items 

RADIO SHACK makes no warranty as to the design. capability. capacity. or suitability for use of the Software. except as provided in 
this paragraph. Software is licensed on an ‘AS IS” basis. without warranty. The orginal CUSTOMER'S exclusive remedy. in the event 
of a Software manufacturing defect. 1s its repair or replacement within thirty (30) calendar days of the date of the Radio Shack sales 
document received upon license of the Software. The defective Software shall be returned to a Radio Shack Computer Center. a Radio 
Shack retail store. participating Radio Shack franchisee or Radio Shack dealer along with the sales document 

Except as provided herein no employee. agent. franchisee. dealer or other person ts authorized to give any warranties of any nature on 
behalf of RADIO SHACK. 

Except as provided herein, Radio Shack makes no express warranties, and any implied warranty of merchantability or fitness for a 
particular purpose is limited in its duration to the duration of the written limited warranties set forth herein. 

Some states do not allow limitations on how long an implied warranty lasts. so the above limitations) may not apply to CUSTOMER 


LIMITATION OF LIABILITY 


A. 


Except as provided herein. Radio Shack shall have no liability or responsibility to customer or any other person or entity with 
respect to any lability. loss or damage caused or alleged to be caused directly or indirectly by “Equipment™ or “Software” sold. 
leased. licensed or furnished by Radio Shack. including. but not limited to. any interruption of service. loss of business or 


anticipatory profits or consequential damages resulting from the use or operation of the “Equipment” or ‘Software’. In no event 
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shail jack be liable for loss of profits. or any indirect. special. or consequential damages arising out of any breach of this 

warranty or in any manner arising out of or connected with the sale. lease. license. use or anticipated use of the “Equipment” or 

“Software’’. 

Notwithstanding the above limitations and warranties. Radio Shack’s liability hereunder for damages incurred by customer or 

others shall not exceed the amount paid by customer for the particular ‘Equipment’ or ‘Software’ involved. 

RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing Equipment and or Software 

No action ansing out of any claimed breach of this Warranty or transactions under this Warranty may be brought more than two (2) 

ee after the cause of action has accrued or more than four (4) years after the date of the Radio Shack sales document for the 
‘quipment or Software. whichever first occurs. 

Some states do not allow the limitation or exclusion of incidental or consequential damages. so the above limitation(s) or exclusionts) 

may not apply to CUSTOMER. 


RADIO SHACK SOFTWARE LICENSE 


RADIO SHACK grants to CUSTOMER a non-exclusive. paid-up license to use the RADIO SHACK Software on ene computer. subject to the 
following provisions: 


G. 


Except as otherwise provided in this Software License. applicable copyright laws shall apply to the Software 

Title to the medium on which the Software 1s recorded (cassette and or diskette) or stored (ROM) is transferred to CUSTOMER. but not 

title to the Software. 

LUSTOMER may use Software on one host computer and access that Software through one or more terminals if the Software permits 
WS function 

CUSTOMER shall not use. make. manufacture. or reproduce copies of Software except for use on one computer and as 1s specifically 

provided in this Software License. Customer is expressly prohibited from disassembling the Software 

CUSTOMER is permitted to make additional copies of the Software only for backup or archival purposes or if additional copies are 

required in the operation of one computer with the Software. but only to the extent the Software allows a backup copy to be made 

However. for TRSDOS Software. CUSTOMER is permitted to make a limited number of additional copies for CUSTOMER'S own use 

CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has purchased one copy of the Software 

for each one sold or distributed. The provisions of this Software License shall also be applicable to third parties receiving copies of the 

Software from CUSTOMER. 

All copyright notices shall be retained on all copies of the Software 


APPLICABILITY OF WARRANTY 
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The terms and conditions of this Warranty are applicable as between RADIO SHACK and CUSTOMER to either a sale of the Equipment 
ane o PST OMRe to CUSTOMER or to a transaction whereby RADIO SHACK sells or conveys such Equipment to a third party for 
lease to : 

The limitations of liability and Warranty provisions herein shall inure to the benefit of RADIO SHACK. the author. owner and or licensor 
of the Software and any manufacturer of the Equipment sold by RADIO SHACK. 


STATE LAW RIGHTS 


The warranties granted herein give the original CUSTOMER specific legal rights. and the original CUSTOMER may have other rights which vary 
trom state to state. 
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About MS-DOS 


MS-DOS™ (pronounced em-es-dos) is a popular, sophisti- 
cated, state-of-the-art operating system for your Model 
20090. For the beginner, who uses the system mainly to run 
applications, MS-DOS’s “everyday” commands are easy to 
use. For the advanced user, who wants an efficient and 
versatile system, MS-DOS offers a wide variety of special 
features. — 


The MS-DOS features include: 


* An editor program, EDLIN, to help you create and 
change your files. 


* Acommand storage area, to let you re-enter or edit the 
last command. 


* “Piping” of commands to let you give more than one 
command at a time to the system. One command's out- 
put becomes another command’s input. 


* A “batch file” process, to let you store a series of com- 
mands to execute whenever you want. 


“Redirection” of command input or output, so it can 
come from or go to files and devices. 


* “Filtering” (transformation) of input before it is output 
(such as the alphabetical sorting of information). 


* A linker program to help you write your own machine- 
language programs. 


* DEBUG, a program to help you test and correct your 
programs. 


One of MS-DOS’s greatest strengths is its multi-level direc- 
tory structure. Suppose that you work on several projects 
— or that other people use your computer. With MS-DOS, 
you can keep related information in small, easy-to-handle 
groups. You can see, at a glance, how material is organ- 
ized. And the computer can pinpoint information quickly 
for rapid access. 
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About This Manual 


This manual shows how you can use MS-DOS to store, 
retrieve, and manipulate information on disk. It is divided 
into five sections: “Introduction to MS-DOS,” “Commands 
Reference,” “EDLIN,” “The Linker,’ and “DEBUG.” 


Before reading this manual or using any com- 
mands, be sure to read your Introduction to Model 
2000 manual. It explains everything you need to know to 
start up MS-DOS and to use it to run application programs. 
It also shows how to use the most commonly used 
commands. 


Section I, “Introduction to MS-DOS” 


This section includes four chapters designed to introduce 
you to the system, its commands, and the many features 
that help you use commands efficiently. 


We strongly recommend that you read all of Section I 
before attempting to use MS-DOS. Be sure, at least, to read 
Chapter 1, “Organization of Information in MS-DOS.” It 
explains the MS-DOS directory structure. After you are 
familiar with this structure, you should be able to quickly 
understand the sample uses and the examples of the 
commands in Section II, “Commands Reference.” 


Section II, “Commands Reference” 


This section contains an alphabetical listing of all MS-DOS 
commands and shows how to use each. 


Section III, “EDLIN” 


This section shows how to use EDLIN to create, update, 
and save files. Using this special program, you can delete, 
insert, edit, or display lines in your source program or text 
files. 


Section IV, “The Linker” 


This section is for assembly-language programmers only, 
It shows how to use the linker program to combine sever- 
al programs into one relocatable load module (a program 
that you can run). 


Section V, “DEBUG” 


This section, also, is for assembly-language programmers // ‘ 
only. It shows how to use the DEBUG program to testand 
edit your executable object files. 


Terms 


Below is a list of terms that we use frequently in this 
manual. Throughout, as in the list, stalicized words repre- 
sent variable information that you must supply. All terms 
are explained in more detail in the Chapter 1. 


disk file A disk area in which you store informa- 
tion. 
directory A disk area that keeps track of your files. 


Each disk may have several directories, 
each of which may contain several sub- 
directories or files or both. 


pathname The name that directs the operating sys- 
tem to a file’s location on disk. The MS- | 
DOS pathname has the general form —_ 


drive:\path\ filename.ext 


drive Specifies the disk that contains the file. 
path Specifies the directory or subdirectory 
that contains the file. 
filename The name you give a file (1-8 characters). 
ext An optional extension (1-3 characters). 
you can use to further identify your file. 
parameter A variable item of information that cus- 
tomizes a command. 
current The drive you are “in” (the drive that 
drive contains the disk you are using). 
current The directory you are in. ef N 
directory = 
root The first directory level on any disk. All 
directory other directories are subdirectories of 


the root directory. 
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Section I 


Introduction to MS-DOS 


This section provides the background information you 
need to make the best use of Section II, “Commands 
Reference.” It also introduces you to MS-DOS’s special 
features. 


Chapter 1, “Organization of Information in MS-DOS” is 
essential to understanding Section II. Be sure to read it 
before using the system. 


Chapter 2, “Introduction to Commands,” familiarizes you 
with the many ways you can use MS-DOS commands. 
It also explains the difference between the types of 
commands. 


Chapter 3, “Introduction to Batch Files,” shows how to 
create and save a series of commands in a batch file. 
Whenever you want, you can run the file, instead of enter- 
ing all the commands again. Chapter 3 also explains the 
Autoexec.bat file, a batch file that runs automatically 
whenever you start up your computer. 


Chapter 4, “MS-DOS Editing Keys,” shows how to correct 
any errors you make when typing commands. 


Chapter 1 


Organization of Information in 


MS-DOS 


After you turn on your computer and start up MS-DOS as 
instructed in your Introduction to Model 2000 manual, 
MS-DOS prompts you to enter the date and time. After you 
do this, the screen displays the system prompt: 


A> 


This means that you are at the MS-DOS command level. At 
this level, you can execute a program or a command. 


Note: To perform any other operation, your system must 
be under the control of an application program. 


If an error occurs while your computer is under the 
control of MS-DOS, the screen displays one of the error 
messages listed in Section II or Appendix A. 


If you get an error not listed, it came from an application 
program. See the application program manual for an ex- 
planation of the error message. 


Entering a Command 


You can enter a command whenever the screen displays 
the system prompt. The command may have up to 125 
characters, including any combination of upper- or lower- 
case letters. End each command by pressing (ENTER). 


For example, type 
CLS (ENTER 


and MS-DOS executes the CLS command, which clears the 
screen and displays the system prompt. 


Executing a Program 


You can also execute a program (such as Inventory Con- 
trol or Accounts Payable) at the system prompt. If what you 
enter is not a recognized command, MS-DOS checks to 
see if it is the name of a program. If MS-DOS finds a 
matching program file, it loads and executes the file. 
Otherwise, the screen displays an error message. 
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Organization of the File System 


Hard Disk Users: The rest of Chapter 1 is written as if you 
have a floppy disk system. Thus, when reading, you should 
substitute your Drive C (assumed to be formatted and 
initialized) when we refer to Drive A and your Drive A 
when we refer to Drive B. 


Disks are devices that store information, both text and 
programs, in separate “files.” MS-DOS handles files in a 
number of ways designed to help you organize informa- 
tion easily and well. 


For instance, with MS-DOS, you can collect groups of files 
into “directories,” much as you would use a file cabinet 
drawer to collect all file folders pertaining to a particular 
subject. Directories, in turn, can be collected into larger 
directories. 


When vou work with MS-DOS files and directories, it’s 
important to remember this multi-level organization. It 
lets you build downward, branching out as you go — 
in effect, creating an upside-down tree of files and 
directories. 


Each user on your system can organize material into sepa- 
rate, easy-to-handle groups without affecting anyone else’s 
material. Both you and MS-DOS can easily locate stored 
material. 


Chapter 1 / Organization of Information in MS-DOS 


Here is a simplified diagram of a typical MS-DOS disk. 


System Drive Directory 


Drive A Root Directory (\) Drive B Root Directory (\) 


USER | PAYROLL ADS 


format.com find.exe diskcopy.con 


JAN MIKE 


|—__, 


MEMOS 


allstaff mers 


DEPT1 DEPT2 tv radio news 
job1 | | | | 
a-m n-z am n-z 


Note: In the commands in this manual, directory names 
are in upper-case and filenames are in lower-case. This is 
only to help you distinguish between directories and files. 
With MS-DOS, you can type all names in upper- or lower- 
case or in any combination of the two. 


When you receive your MS-DOS system disk, it has only 
one directory, the “root” directory. The root contains all 
external command files. “Internal commands” are built 
into the computer. “External commands” are those that 
reside on disk. Format.com, Find.exe, and Diskcopy.com 
are only a few of MS-DOS’s external commands. 


The Drive A root directory is the root from which the rest 
of the disk’s file system “grows.” The shorthand notation 
for a root directory is a backwards slash (\). 


In the system diagrammed here, the user has added the 
USER directory to Drive A. This system also contains a 
second disk, with its own root directory. (Root directories 
are automatically created when you initialize a disk using 
the FORMAT command.) 
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Names 


On the Drive B disk, the user has created directories called 
PAYROLL and ADS. PAYROLL, in turn, contains two other 
directories, each of which contains two files. The ADS 
directory contains three files. 


Each file has a name. Names can include from 1 to 8 
characters. Usually, you'll use letters and numbers: 


* Upper-case letters (A-Z) 

¢ Lower-case letters (a-z) 

* Decimal digits (0-9) 

The following symbols also are allowed in filenames: 
$ & # % ° ( ) - 

@ * { } ~~ * 3 


Warning: Do not include more than eight characters in a 
filename. If you do, MS-DOS truncates the filename to the 
first eight characters and accepts it. This can cause prob- 
lems. For example, MS-DOS truncates both Johnfile1 and 
Johnfile2 to Johnfile. Because two files (that are in the 
same directory) cannot have the same name, MS-DOS 
overwrites the old file with the new file. 


Extensions. You can use an “extension” to provide addi- 
tional information on a file. Extensions are always pre- 
ceded by a period (.) and can be from 1-3 characters long. 


Using extensions such as .new, .irs, and .pay, you can 
distinguish files that have the same name or can divide 
files into categories. 


You can also use an extension to indicate the file type. For 
example, you may wish to use some of the following: 


-bas for BASIC programs 
txt for ASCII text 

.dat for Data files 

obj for Object code 

rel for Relocatable code 
<SEC for Source code 
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If you add the extension .dat to the inventory name, the 
filespec becomes 


invntory.dat 


Once you include an extension in a filename, you 
must use it whenever you specify the file. 


Warning: Again, do not include more than three charac- 
ters. If you do, MS-DOS truncates the extension to the first 
three characters and accepts it. 


Examples of Filenames. Some legal names are: 


rawdata2 
REPORTS 
X.x 
project% .txt 
PROGI.bas 
SAMFILE 
2AR.dat 


Some illegal filenames are: 


max*min (because * isn’t a legal character 
for names) 

-DATA (because the period can be used 
only to separate the filename and 
extension ) 

open orders (because a name can’t contain a 
space ) 


Wild Cards. MS-DOS lets you use these shorthand nota- 
tions in filenames and extensions: 


? The question mark indicates that any character can 
occupy that position. 


* The asterisk indicates that any character can occupy 
that position or the remaining positions in the file- 
name or extension. 


Suppose you specify this filename: 


test?run.exe 
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Pathnames 


MS-DOS finds all files (in one directory) that begin with 
“test,” have any character next, followed by “run,” with the 
extension .exe. Here are some files MS-DOS might find: 


Test1run.exe 
Test3run.exe 
Test4run.exe 


If you specify this filename: 
test*.exe 


MS-DOS finds all files (in one directory) that begin with 
“test” and have the extension .exe. In addition to the files 
listed above, MS-DOS might find others, including 


Test.exe 
Testall.exe 
Test1.exe 


If you specify this filename: 
oldfile.* - 


MS-DOS finds all files named Oldfile (in one directory), ~— 
regardless of their extensions. Here are examples of some 
files it might find: 


Oldfile.bas 
Oldfile.exe 
Oldfile.txt 


Whenever you want to access a file, you must tell MS-DOS 
where to find it. You provide the information in the form 
of a “pathname,” a list of names from the root directory 
down to the file you want to access. Each pathname can 
have up to 63 characters. 


Suppose, for example, that you want to access the Radio 

file on the disk in Drive B. Tell MS-DOS the path to follow ™, 
from the root directory to the file, separating the “stops 
along the way” with backslashes, as follows: 


B:\ADS \ radio 
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MS-DOS reads the pathname, from left to right, to deter- 
mine that the file you want is on Drive B, in the ADS 
directory, and that its name is Radio. 


MS-DOS's multi-level organization and pathname conven- 
tion help you access files quickly. It also lets you give two 
files the same filename, as long as you store them in 
separate directories so that they have different pathnames. 


Note: Under some circumstances, you can take a “short- 
cut” to a file or directory. See “Current Directory.” 


Device Names 


Each input/output device supported by the system has a 
unique name. The device names are as follows: 


* AUX (auxiliary) refers to whatever device you set up as 
the auxiliary device 


* CON (console) refers to the screen or keyboard 
* PRN (print) refers to the printer 
* LST (list) refers to the printer 


Never use a device name as a filename. 


Directories 


On MS-DOS, directories, which are collections of files, are 
nonetheless files themselves. They are processed by the 
same input/output functions used with regular files. 


Using Directories 


To understand how directories work, assume that the disk 
in Drive B is freshly formatted so that it has only a root 
directory. You can use the editor, EDLIN, to create the test 
file File1.tst Drive B. To do so, type 


EDLIN B:\file1.tst 
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EDLIN displays 


New file 


The asterisk indicates that EDLIN is ready for you to enter a 
command. To enter the insert mode, so that you can enter 
text lines into the file, type 


| (ENTER 


EDLIN displays the line number followed by a colon and 
asterisk. It places each line into the text file until you type 


ENTER) or (CTRL) (_Z_) (ENTER) to end the file. 


Create this file: 


1:“This is my test file. ENTER 
2:*I’m using it to show the use of directories. (ENTER 
3:*(F6) (ENTER 


After you press ENTER), EDLIN displays the asterisk to 
indicate it’s ready for another command. To exit EDLIN 
and return to MS-DOS, type 


E (ENTER 
MS-DOS displays the system prompt again. 


If you use the DIR command, which lists the files in a 
directory, it now indicates the existence of the new file: 


DIR B:\ (ENTER 
Volume in drive B has no label 


Directory of B:\ 
PILE TST 70 8-24-83 9:07a 


1 File(s) nnnnnn bytes free 


You can use the TYPE command to display the text stored 
in the file: 


TYPE B:\file1.tst 


This is my test file. 
I'm using it to show the use of directories. 
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Suppose you use EDLIN to create two more text files. 


EDLIN B:\file2.tst 


New file 
*| (ENTER 


1:“This is my second file (ENTER 
2:"I'm using it to show the use of directories 
3:*(F6) (ENTER 


*“E (ENTER 


EDLIN B:\file3.tst 


New file 
*| (ENTER 


i<This is my third file (ENTER 
2:*I'm using it to show the use of directories 
3:*(6) (ENTER 


i 

Now if you use DIR, it shows three file names: 
DIR B:\ 

Volume in drive B has no label 


Directory of B:\ 


FILE1 TsT 70 8-24-83 9:07a 

FILE2 TST 70 8-24-83 9:09a 

FILES TST 69 8-24-83 9:09a 
3 File(s) nnnnnn bytes free 


Creating Directories 


To create a directory on the system, use the MKDIR com- 
mand. Suppose that you want to create in the Drive B root 
directory a new directory called MYDIR. Type 


MKDIR B:\MYDIR 
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MS-DOS automatically makes MYDIR a subdirectory of the 
Drive B root directory. You can check it by using DIR: 


DIR B:\ 
Volume in drive B has no label 


Directory of B:\ 


FILE1 TST 70 = 8-24-83 9:07a 

FILE2 TST 70 ~=—- 8-24-83 9:09a 

FILES TST 69 8-24-83 9:09a 

MYDIR <DIR> 8-24-83 9:09a 
4 File(s) nnnnnn bytes free 


Now suppose you want to copy File1.tst to the new direc- 
tory. Use the COPY command, as follows: 


COPY B:\file1.tst B: \MYDIR \newfile1.tst 


Here’s what the structure looks like now: 
Drive B Root Directory (\) 


| ae Se 
MYDIR File1.tst File2.tst File3.tst 


Newfile1.tst 


You can use DIR to see the name of the file in the new 
directory: 


DIR B:\MYDIR (ENTER 
Volume in drive B has no label 


Directory of B:\ 


<DIR> 8-24-83 9:09a 

<DIR> 8-24-83 9:09a 

NEWFILE1 TST 70 = 8-24-83 9:07a 
3 File(s) nnnnnn bytes free 


It’s possible to use MKDIR to create a subdirectory of 
MYDIR, a subdirectory of the new directory, and so on. 
Your only limit is disk space availability. 
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Note: See “Anonymous Directory Names” for an explana- 
tion of the . and . . symbols. 


__' Deleting Directories 


(n\ 


When deleting a directory, you must first remove all the 
files it contains. If you delete a directory while it still 
contains files, MS-DOS has no way — no path — to access 
those files, or to return their storage to the storage pool. 


To delete a directory, follow these steps: 


1. Use the DIR command to see what files are in the 
directory. 


2. Use the COPY command to copy any files you may need 
to another directory. 


3. Use the ERASE command to remove all files from the 
directory. 


4. Use the RMDIR command to remove (delete) the 
directory. 


The Current Drive 


With MS-DOS, the disk you are using at any given time is 
your “current disk” or “current drive.” Immediately after 
startup, MS-DOS places you in the root directory of the 
Drive A disk. Thus, Drive A is your current drive. 


Using the Current Drive. Knowing about the current 
drive enables you to take “shortcuts” when specifying 
pathnames. It also lets MS-DOS find what you want more 
quickly. 


* When specifying a file or directory that is not in the 
current drive, you must specify the entire pathname. 


* When specifying a file or directory that is in the current 
drive, however, you need not include the drive speci- 
fication in the pathname. 
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For example, suppose you are in A:\. If you want to access 


B:\ PAYROLL, specify the drive, as well as the directory 
name: -o 


B:\ PAYROLL 


If you want to access A:\ USER, specify only the directory 
name: 


\USER 


Changing the Current Drive. MS-DOS lets you quickly 
change the current drive. To do so, enter the drive speci- 
fication at the system prompt. For example, at A>, type 


B: (ENTER) 


MS-DOS displays a new system prompt, }>, to indicate 
you are now in Drive B. 


The Current Directory 


The directory you are using at any given time is your - 
“current directory.” Therefore, immediately after startup, 
the root directory of Drive A is your current directory. 


Using the Current Directory. Knowing about the cur- 
rent directory lets you take even more shortcuts when 
specifying pathnames. 


¢ When specifying a file or directory that is higher than the 
current directory, and on the same disk, you must give a 
complete pathname (minus the drive specification). 


° When specifying a file or directory that is within or lower 
than the current directory, and on the same disk, you 
may begin the pathname immediately below your cur- 
rent directory. The rest of the pathname is implied. 


For example, suppose you are in the directory 
A:\USER\ MIKE. If you want to access the \USER directory 

on the same disk, give the complete pathname (minus the amy 
drive specification): 


\USER 
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If you want to access the \USER\ MIKE \ MEMOS directory 
on the same disk, begin the pathname below the current 
directory, as follows: 


MEMOS 


Notice that you should not precede this pathname with a 
backslash. That is because the pathname \MEMOS speci- 
fies a directory that does not exist — one that would be an 
immediate subdirectory of the root directory. 


If you are still in \USER\ MIKE, you can specify a file in 
that directory by giving only the filename. For example, if 
you type 


job1 

the complete pathname \USER\MIKE\job1 is implied. 
Again, if you are still in \USER\ MIKE and you type 
MEMOS \mgrs 


the complete pathname \USER\ MIKE \ MEMOS \ mers is 
implied. 


When you enter commands, MS-DOS automatically ex- 
pands pathnames as needed. For example, if you type 


COPY job1 MEMOS \newjob1 

MS-DOS interprets this as 

COPY \USER\MIKE \job1 
\USER\MIKE\ MEMOS \newjob1 


Changing the Current Directory. Using the CHDIR 
command, you can make any directory on the current 
drive your current directory. To do this, enter the CHDIR 
command followed by the pathname of the new current 
directory. 


For example, to change the current directory from A:\ to 
A:\USER\ MIKE type 


CHDIR \USER\MIKE 
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To change to a directory on another drive, simply change 
drives before using the CHDIR command. For example, to 
change your current directory to B:\ PAYROLL, type (= 


B: (ENTER) 


MS-DOS automatically puts you in the root directory of 
Drive B. To change to \PAYROLL, type either of the 
following: 


CHDIR PAYROLL 
CHDIR \PAYROLL 


Home Directories 


Suppose your current directory is B:\ PAYROLL and then 
you change it back to A:\USER\ MIKE. MS-DOS “remem- 
bers” that you were using B:\PAYROLL. For your con- 
venience, it makes \PAYROLL the “home directory” of 
. Drive B, until you change to another Drive B directory. 


Using Home Directories. This means that whenever 
you specify a file or directory within or below 
B:\ PAYROLL, you need not include the directory name 
PAYROLL. 


‘) 


For example, suppose you are in Drive A. If you type 
TYPE B:allstaff 

MS-DOS assumes you mean B:\ PAYROLL \allstaff. 
Similarly, if you type 

DIR B: 


MS-DOS assumes you mean DIR B:\ PAYROLL; it shows a 
directory listing of all the files in the PAYROLL directory. It 
does not show a directory listing of the entire disk. For 
this, you must type 


DIR B:\ 


—— 
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Knowing about home directories is particularly helpful 
when you are copying files. Suppose you must copy sever- 
al files from A:\USER\MIKE to B:\PAYROLL. Make 
B:\PAYROLL the home directory of Drive B; then make 
A:\USER\MIKE your current directory. Now you can copy 
each file, specifying only the filenames. 

If you type 

COPY job1 newjob1 (ENTER 

MS-DOS interprets this as 


COPY A:\USER\MIKE \job1 
B:\ PAYROLL \ newjob1 


Anonymous Directory Names 


Sometimes you may need to refer to your current direc- 
tory, or a higher-level directory, although you may not 
know the full pathname. Or you may want merely to save 


typing time. 
In either case, MS-DOS makes special “name substitutes” 
available: 


“oo 


* The name “.” refers to the current directory 


> 


* The name “..” refers to the “parent” of the current 
directory (the next highest-level directory in the path) 


* The name “..\..” refers to the directory two levels up 


You can use the names in place of pathnames and/or as the 
first names in pathnames. Some examples: 


DIR. 

lists filenames in the current directory. 

DIR.. 

lists names in the current directory’s parent directory. 
ERASE . .\taxes84 


deletes the Taxes84 file from the current directory’s 
parent directory. 
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The substitute names may refer to either the current direc- 
tory or the home directory of another drive, depending 
upon whether you include a drive specification. For 
example, 


ERASE B.:. .\taxes84 


erases the Taxes84 file from the parent directory of the 
home directory of Drive B. 
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Chapter 2 
Introduction to Commands 


Commands are a way of instructing the computer to per- 
form useful tasks. Here are a few of the things MS-DOS 
commands let you do: 


Format disks to accept MS-DOS files (get them ready for 
information storage) 


Copy the MS-DOS system (all system files) to another 
disk 


Copy all information (system and data files) from one 
disk to another and (optionally) compare the disks 


Create, copy, display, rename, and remove files 


Execute system programs, such as EDLIN and DEBUG, as 
well as your own programs 


Create, list, and remove directories 


Enter the date, time, and remarks 


Set various printer and screen options 


Request MS-DOS to pause 


Types of MS-DOS Commands 


The two types of MS-DOS commands are: 
* Internal 
* External 

Internal Commands 


These are the simplest, most commonly used commands. 
When you do a directory listing on your MS-DOS disk, you 
cannot see these commands. When you enter them, they 
execute immediately. The following internal commands 
are described in Section II: 
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BREAK EXIT REN 
CHDIR (CD) FOR RMDIR (RD) 

CLS GOTO SET on™ 
COPY IF SHIFT < 
CTTY MKDIR (MD) ‘TIME 

DATE PATH TYPE 

DIR PAUSE VER 

ECHO PROMPT VERIFY 

ERASE (DEL) REM VOL 


External Commands 


These commands reside on disks as program files. There- 
fore, MS-DOS must read them from disk before it can 
execute them. If the disk containing the command is not 
in the drive, the system cannot find and execute the 
command. 


Note: MS-DOS must also know in which directory or drive 
to search for external commands, or it cannot execute 
them. (See the PATH command.) - 


Any filename that has an extension of .com, .exe, or .bat is Sy 
considered an external command. For example, programs 

such as FORMAT.COM and DISKCOPY.COM are external 
commands. You may create external commands and add 

them to the system. Programs that you create with most 
languages (including assembly language) are .exe (ex- 
ecutable) files. 


When you enter an external command, do not include its 
filename extension. The following external commands 
are described in Section II: 


BACKUP HFORMAT 

CHKDSK MORE 

COMPDUPE PRINT 

DISKCOPY RECOVER 

EXE2BIN RESTORE f 
FIND SORT -_ 
FORMAT SYS 
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Command Parameters 


In Chapter 1, you learned about the pathname. This is only 
one of several “parameters” you may use to customize 
your commands. 


Some parameters are required; others are optional. If you 
omit an optional parameter, the system may automatically 
provide a “default” value. For example, as you should 
recall from Chapter 1, the system defaults to the current 
drive whenever you omit the drive part of a pathname. 


Required and optional parameters and default values — 
other than those discussed in Chapter 1 — vary according 
to the particular command. (See the particular command 
in Section IJ for more information.) 


Here are examples of other parameters: 


filespec specifies the file in the format 
drive filename.ext, such as B:Text.txt. All 
parts of the filespec are optional. 


ON OFF are “arguments,” parameters from be- 
tween which you choose. Arguments 
provide more information to a com- 
mand. For example, BREAK ON turns on 
the C€_) check. 


IW is an example of a “switch,” a parameter 
that controls a command. For example 
when you use /W with the DIR com- 
mand, MS-DOS shows the “wide dis- 
play” version of the directory. Precede 
all switches with a slash. 
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Information Common to All MS-DOS 
Commands 


The following information applies to all MS-DOS 
commands: 


° The system prompt is the current drive designation 
followed by a greater-than sign. For example, A> tells 
you that Drive A is your current drive and that MS-DOS is 
ready to accept a command. 


Commands are usually followed by one or more 
parameters. 


Parameters, like commands, may be entered in upper- 
case or lower-case, or a combination. 


Commands and parameters must be separated by de- 
limiters. The space and comma are the easiest to use. 
Examples: 


DEL MYFILE.OLD NEWFILE.TXT 
rename, afile bfile 


You may also use the semicolon (;), equal sign ( = ), or 
TAB) as delimiters. This manual uses a space. 


Wild cards and device names (such as PRN and CON) are 
not allowed in command names. 


source pathname specifies the disk from which you 
transfer information. target pathname specifies the disk 
to which you transfer information. Some error messages 
refer to the “destination.” This is the same as the target. 


When typing commands, you may use the MS-DOS edit- 
ing and function keys. (See Chapter 4.) 


Commands execute only after you press (ENTER). 


By pressing CTRL) C€_), you can abort a command when 
it is running. 
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* When a command produces much screen output, the 
display automatically scrolls to the next screen. To 
suspend the display, press CS) or GOLD). To 
resume, press CQ) or GOLD). 


Input and Output 


MS-DOS assumes that command “input” comes from the 
keyboard and “output” goes to the screen. However, you 
can redirect input so it comes from a file and output so it 
goes to a file or a line printer. 


In addition, you can create “pipes” that let one command’s 
output become another’s input. 


Redirecting Input 


Redirecting 


SORT 


sorts the information you enter from the keyboard and 
displays the sorted output. To end keyboard input, press 


CTRL) (Z_) (ENTER). 


To redirect input so it comes from a file, use a less-than 
sign (<) in your command. For example, 


SORT <names 


sorts the information in the file Names and displays the 
sorted output. 


Output 
DIR 


displays a list of all the directories that are on the current 
disk. 

To redirect output so it goes to a file, use a greater-than 
sign (>) in your command. For example, 


DIR >myfiles 


sends the same listing to the file Myfiles in the current 
directory. If Myfiles does not already exist, MS-DOS cre- 
ates it and stores the listing in it. If Myfiles does exist, 
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Filters 


MS-DOS overwrites the old information with the new 
information. 


Rather than replace an entire file, you may want to 
“append” your output to the end of it. To do this, use two 
greater-than signs. For example, 


DIR >>myfiles (ENTER 


appends your directory listing to the file Myfiles in the 
current directory. If Mvfiles does not exist, MS-DOS cre- 
ates it. 


Here is an example in which both the input and output are 
redirected: 


SORT <names >list 1 (ENTER 


sorts the information in the file Names and sends the 
sorted output to the file Listl in the current directory. 


A “filter” is a command that transforms input in some way 
(filters it) before outputting it — usually to the screen ora 
file. 


The MS-DOS filters are FIND, MORE, and SORT. Their 
functions are as follows: 


* FIND — Searches for a constant string of text in a file 


* MORE — Takes standard screen output and displavs it, 
one screen at a time 


¢ SORT — Sorts text from A-Z or from Z-A (reverse sort) 


By combining commands and filters, you can replace 
several commands with a few filters. The section below 
tells you how. 
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Command Piping 


“Piping” lets you give more than one command ata time to 
the system. It does this by making one command’s output 
another command's input. 


To pipe commands, simply divide them with the “pipe 
separator,” the vertical bar (|). All output generated by the 
command to: the left of the bar becomes input for the 
command to the right. 


For example, suppose you have a program that produces 
output in columns. You may want to sort this output. This 
command: 


DIR | SORT 


displays an alphabetically sorted listing of the current 
directory. This command: 


DIR | SORT >direc.fil 


sends the same listing to the file Direc.fil in the current 
directory. If the file doesn’t exist, MS-DOS creates it. This 
command: 


DIR B: | SORT >B:direc.fil 


makes an alphabetically sorted listing of the home direc- 
tory of Drive B. It then sends the listing to the file Direc. fil 
in the home directory on Drive B. Again, MS-DOS creates 
the file, if necessary. 
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Batch Files: 
Executing Several Commands 


Some tasks require you to enter two or more commands. 
For example, when preparing a disk for informaton stor- 
age, you must format the disk so you can write to it 
(FORMAT command). In addition, it is a good habit to 
immediately check the directory of the new disk for errors 
(CHKDSK command). 


The Batch File 


With MS-DOS, you can put such a command sequence into 
a special file called a “batch file.” Then you can execute the 
entire sequence simply by entering the name of the batch 
file. 


When you create a batch file, you may specify the complete 
pathname, a filespec, or a filename. In any case, you must 
give the file the extension .bat. When you execute the 
file, however, enter the filename without the extension. 


Below is a description of how to use the COPY command 
to create a batch file. (You may also use EDLIN.) 


Creating a Batch File 


To create a file to perform FORMAT and CHKDSK as 
discussed above, type this at the system prompt: 


COPY con prepdisk.bat 


This command tells MS-DOS to copy the information en- 
tered from the keyboard (console) into a batch file called 
Prepdisk.bat. Because you do not specify otherwise, MS- 
DOS creates the file in the current directory. 


MS-DOS again displays the system prompt. Now you can 
type the commands to be included in the file. Type 


REM This is a file to prepare and check new disks 
REM It is called Prepdisk.bat 
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FORMAT B: 
PAUSE 
CHKDSK B: 


After entering the last command (CHKDSK B:), you are 
ready to save the commands in the file. To do this, simply 
press (F6) (ENTER) or CTRL) CZ_) (ENTER) at the next system 
prompt. MS-DOS displays ~7% to indicate you used the 
control character. Then it displays 


1 File(s) copied 
At this time, you may want to type DIR (ENTER) to verify that 
the file is created. 


REM and PAUSE 


Two of the commands above — REM and PAUSE — are 
available only for use in batch files. 


The REM command lets you include remarks in your batch 
file, without those remarks being executed as commands. 
The remarks in the Prepdisk.bat file are to remind you 
what the file does. Should you forget, you can type 


TYPE prepdisk.bat 


and MS-DOS displays the contents of the file, including the 
remarks. 


The PAUSE command lets you control how much of the 
file you want to execute. When it reaches a PAUSE com- 
mand, MS-DOS pauses and displays the message: 


Strike a key when ready... 


You may continue execution by pressing (SPACEBAR) or 
abort it by pressing (CTRL) CC_). 


(The REM and PAUSE commands are explained further in 
Section II.) 


Executing a Batch File 


To execute your batch file, you must be in the directory 
that contains the file. (If you are not in it, execute a CHDIR 
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command as described in Section II.) Then enter the 
filename, without the extension. For example, to execute 
Prepdisk.bat, type this at the system prompt: 


prepdisk 


Execution proceeds just as if you entered each command 
line at the keyboard. 


A Word of Advice about Batch Files 


As you are getting acquainted with MS-DOS, we strongly 
recommend that you create all batch files in the root 
directory of your MS-DOS disk. 


Later, when you better understand MS-DOS, you may want 
to create batch files elsewhere. You can do this by specify- 
ing a complete pathname for the file. If you do so, howev- 
er, keep in mind the following: 


* When you execute a batch file, you must be in the 
directory that contains the file. (That directory becomes 
your current directory and that drive becomes your 
current drive.) 


* MS-DOS searches only the current directory for external 
commands. 


Therefore, if you use any external commands in your 
batch file, you may need to do one of the following: 


¢ Use the PATH command to tell MS-DOS to search for 
external commands in the directory that contains the 
commands. 


* Use the COPY command to move your external com- 
mands to the directory that contains your batch file. 


* Use the CHDIR command within your batch file to move 
from one directory to another as necessary. 
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Summary of the Batch File Process 


1. Create the file by typing a 
COPY con pathname.bat ; 

2. Enter the command lines. 

3. Save the file by typing either of the following: 


(ENTER) 
@) 


4, When you are in the directory that contains the file, 
execute the file by typing 


filename (ENTER 


The Autoexec.bat File 


An Autoexec.bat file lets you execute programs or com- 

mands automatically when you start MS-DOS. This is use- 

ful when you want to run a specific package under MS- oo 
DOS or when you want MS-DOS to execute a batch file 
automatically each time you start the system. Using an 
Autoexec.bat file, you can avoid loading two disks to do 

either of these tasks. 


When you start MS-DOS, the command processor 
searches the MS-DOS disk for a file called Autoexec.bat. If 
MS-DOS finds the file, it immediately executes it, by- 
passing the date and time prompts. 


If MS-DOS does not find an Autoexec.bat file, it displays 
the date and time prompts as usual. 


Creating an Autoexec.bat File 


The Autoexec.bat file must be created in the root directory 
of your MS-DOS disk. (You must be in that directory when 
you create the file.) You create it the same way as any other om 
batch file, except that you give it the name Autoexec.bat. 


Remember, if you use an Autoexec.bat file, MS-DOS 
prompts you for a current date and time only if you 
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include the DATE and TIME commands in the file. Because 
MS-DOS uses this information to keep the directory cur- 
rent, you should always include these commands. 


Suppose, for example, you want to load BASIC and run a 
BASIC program called MENU each time you start MS-DOS. 
To create and save a file that does this, type 


COPY con Autoexec.bat 
DATE 

TIME 

BASIC MENU 


The Autoexec.bat file is a great time-saver. You can use it to 
execute many programs and any series of commands. 


Batch Files with Replaceable 
Parameters 


When creating a batch file, you may want to include re- 
placeable (dummy) parameters. In this way, you can use 
different sets of data when you run the file. 


For example, the Prepdisk.bat file shown earlier is 
changed here to include the dummy parameter %1. 


COPY con prepdisk.bat 

REM This is a file to prepare and check new disks in 
a specified drive 

REM It is called Prepdisk.bat 

FORMAT %1 

CHKDSK %1 


To execute this file to format the disk in Drive B, enter the 
batch file’s name, followed by the drive specification to 
replace %1, as shown here: 


prepdisk B: 


The next two sections tell more about creating and execut- 
ing batch files that have dummy parameters. 
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Creating a Batch File with Replaceable 


Parameters 


The dummy parameters are %0 through %9. MS-DOS 
always replaces %0 with the filename (without extension) 
of the batch file, unless you use the SHIFT command. It 
replaces the other dummy parameters, sequentially, with 
the parameters you specify when you execute the batch 
file. (See the SHIFT command in Section II if you wish to 
specify more than 10 dummy parameters.) 


These parameters may be pathnames, drive specifications, 
numeric values, or almost anvthing else vou can think of. 


For example, if vou type 


COPY con myfile.bat 
COPY %1.mac %2.mac 
TYPE %2.mac 

TYPE %0.bat 


MS-DOS creates the batch file Myfile.bat in the current 
directory and copies the next three lines into that file. 


When you execute the file, the parameters %1 and %2 are 
replaced sequentially by the pathnames vou supplv. 


Executing a Batch File with Replaceable 


Parameters 


To execute a batch file that has replaceable parameters, 
enter the batch filespec (without its extension), followed 
by the parameters to replace the dummy parameters. 


For example, to execute Myfile.bat, type 
myfile A:prog1 B:prog2 (ENTER 


Myfile is substituted for %0, A:Prog] for %1, and B:Prog2 
for %2. 


The result is the same as if you had entered each of the 
commands with its parameters, as follows: 


COPY A:prog1.mac B:prog2.mac 
36 
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TYPE B:prog2.mac (ENTER 
TYPE myfile.bat (ENTER 
The COPY command copies the contents of one file to 


another file. The TYPE command displays the contents of a 
file. 


The following table illustrates how MS-DOS replaces each 
of the above dummy parameters: 


Dummy Parameter %0O %1 %2 
Parameter Mvfile Prog] Prog2 
Parameter & Ext. Myfile.bat Progl.mac — Prog2.mac 


Sample Use of Replaceable Parameters 


Replaceable parameters can be verv handy in day-to-day 
use with application programs. For example, suppose you 
have a program that creates a client mailing list and saves 
the list to a file called Mail.dat in the root directory of your 
system disk. 


The information in Mail.dat might look like this: 


Tom Cleo 2. 8thSt. Lincoln NE 68502 
Ann King 1  9thAv. Rapid City SD 57001 
Sam Beck 4. 6thSt. Ft. Worth TX 76133 


As vou can see, the information is in random order. Using 
a batch file with replaceable parameters, however, vou can 
organize the information in any wav that is most conven- 
ient at any given time. One time, vou might organize it 
according to zip code; another time, according to last 
name; and so on. To create such a batch file, type the 
following: 


COPY con mailsort.bat 

COPY mail.dat %1.dat 

TYPE %1.dat 

SORT %2 <%1.dat >%3.dat 


TYPE %3.dat 


Suppose you execute the batch file by tvping 


mailsort newmail /+ 15 sort (ENTER 


37 


Section I / Introduction to MS-DOS 


The result is the same as if you had entered each command 
with its parameters, as follows: 


-- 
COPY mail.dat newmail.dat (ENTER 
TYPE newmail.dat (ENTER 
SORT /+15 <newmail.dat >sort.dat (ENTER 
TYPE sort.dat (ENTER 
MS-DOS copies the information from Mail.dat into New- 
mail.dat and then displays the contents of Newmail.dat. It 
then sorts the contents, starting at Column 15 (it sorts 
alphabetically, according to last name). Finally, it copies 
the sorted data to the file Sort.dat and displays it. 
Note: By piping commands, you can reduce your batch 
file to two command lines. 
COPY mail.dat %1.dat | TYPE %1.dat | SORT /+15 
>%3.dat (ENTER 
TYPE %3.dat (ENTER 
om 


Reminders about Batch Files 


The following list summarizes information you should 
know before you execute a batch process with MS-DOS: 


* Do not enter the filename Batch (unless the name of the 
file you want to execute is Batch.bat). 


* To execute a batch file, enter the filename without the 
extension. 


¢ The commands in the file named filename.bat are 
executed, 


° If you press CTRL) CC) while in batch mode, this 
prompt appears: 


Terminate batch job (Y/N)? 


If you press CY_), MS-DOS ignores the rest of the com- 
mands in the batch file. The system prompt is displaved. 


If you press CN), the current command ends. Batch 
processing continues with the next command in the file. 
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* If you remove the disk that contains the batch file being 
executed, MS-DOS prompts you to insert it again so that 
the next command can be read. 


Immediately upon executing one batch file, you may call 
another. To do so, simply put the second file’s name 
(without its extension) as the last command in the first 
file. 


Ina batch file, you may want to refer to a file whose name 
contains a percent sign. For example, you may want to 
include a command that copies the file Abc%.exe. As you 
know, the batch file normally interprets the percent sign 
as a replaceable parameter. To indicate that this is not 
the case, you must include a second percent sign. The 
batch file command, then, might be this: COPY 
A:\ USER \abc% %.exe B:\ USER. 
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Correcting Errors and Editing 
Commands 


If you make a mistake in typing a command line and have 
not pressed (ENTER), you can use one of the following keys 
to correct the mistake. 


° (BACKSPACE) — backs up the cursor, erasing the last 


character 
° — voids the command line and lets you start over 


Suppose, however, that you have pressed (ENTER). What 
then? With many operating systems, you must retype the 
entire command — but not with MS-DOS. 


The Template 


When you press (ENTER) after typing a command, MS-DOS 
sends the command to the command processor (COM- 
MAND.COM) for execution. In this way, it is like other 
Operating systems. 


Unlike other systems, however, MS-DOS also sends the 
command to a special storage area called the “template.” 
The template stores only one command at a time — the 
last command entered. 


You can then recall the command from the template and 
can do any of the following: 


* Repeat the command instantly by pressing (F3) (ENTER). 


¢ Edit the command and retry it, without retyping the 
entire line. 


* Edit the command line into a similar command so that 
you don’t have to type the entire new command. 
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The Editing Keys 


The table below summarizes the MS-DOS editing keys. 
The next section gives an example of how to use the keys. 
At the end of the chapter is a summary of control character 
keys. 


Note: You can also use the editing keys to edit your text 
files. How to do so is described in Section III, “EDLIN.” 


Function Key(s) Description 


Copy char Copies one character (from 
the template to the command 
line) and displays it. 


Delete char Deletes a character from the 
template. Therefore, the 
character is skipped (is not 
copied to the command line). 


Copy to char (F2)char Copies all characters up to the 
specified character and 
displays them. 


Delete to char (F4)char Deletes all characters up to 
the specified character from 
the template. Therefore, the 
characters are skipped (are 
not copied to the command 
line). 


Copy all (3) Copies all remaining 
characters and displays the 
entire command line. 


Insert Enters the insert mode. (3) 
ends the insert mode.) 


a 


Replace Makes the new line the new 

template template, but does not send it 
to the requesting program. 
(Accepts the line for more 
editing. ) 

Void line or CX) Voids the current input. Leaves 
the template unchanged. Type 
and enter a new line, or press 
to display the system 
prompt. 
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Function 


Enter line 


End-of-file 
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Key(s) Description 


ENTER Makes the new line the new 
template and sends it to the 
requesting program. 


or Puts an end-of-file character in 
CTRL) CZ) the new template. 


Sample Uses of Editing Keys 


Suppose you have two files, Prog.com and Prog.asm, in the 
root directory of your MS-DOS disk. If you type the follow- 
ing command: 


DIR prog.com 


MS-DOS displays information about the file Prog.com. At 
the same time, it saves the command line (DIR prog.com) 
in the template. 


Press (F3) to display the command line. (The underscore 
represents the blinking cursor.) 


(F3) DIR prog.com. 
Execute the command again by pressing (ENTER). 


To display information about the file Prog.asm, edit the 
command line DIR Prog.com. Type: 


(F2)C 


MS-DOS displays all characters of the command line up to 
but not including the letter c, as shown here. 


DIR prog... 

Now type 

asm. 

The letters asm replace the letters com, resulting in 
DIR prog.asm- 


This new command line is now in the template. To ex- 
ecute it, press (ENTER 


43 


Section I / Introduction to MS-DOS 


Replace DIR with the TYPE command by typing 
TYPE: 


The characters TYPE automatically replace the characters 
DIR and the space that followed. 


Now type 
INSERT) (SPACEBAR) (F3) 
Pressing (INSERT) (SPACEBAR) lets you insert a space. 3) 


copies the rest of the template. The result is 
TYPE prog.asm_ 
To execute the new command, press (ENTER). 


Suppose you had misspelled TYPE as BYTE, but had not 
entered the command. (Set up this situation quickly by 
typing BYTE and pressing (F3) again.) Your screen displays 
BYTE prog.asm_ 

You can still use some of what you have typed. To do so, | 
press (F5). The symbol (@ appears at the end of the line. 


This indicates that MS-DOS has put the new line in the 
template, although it has not sent the line to be executed. 


You can now edit the line BYTE prog.asm so it becomes 
rYPE program.asm To do so, type 


TPES) 


The key copies a single character (Y) from the tem- 
plate to the command line. The resulting command line is 
the command you want: 


TYPE prog.asm- 


Here is another way to change BYTE prog.asm to TYPE 
prog.asm. Press (F5) again. Then press 


DELETE) (DELETE INSERT) YP(F3) 


Pressing (DELETE) twice deletes the first two characters (B 
and Y). G) copies the third character (T). (INSERT) enters 
the insert mode, so you can insert the letters Y and P. Then 
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(F3) copies the rest of the template. 


Notice that does not affect the command line. It 
affects the template by deleting the first character. Similar- 
ly, deletes characters in the template, up to but not 
including a given character. 


The Control Character Keys 


Acontrol character key is one that affects a command line. 
You have already learned about CTRL) CC). Others are 
described below. 


Remember that when you type a control character you 
must press the second key while holding down the first. 


Key(s) 
CTRL) CC_) 
SHIFT) (PRINT 


PRINT 
or (CTRL) CP_) 


(CTRL) CN) 


CTRL) CH_) 
or (BACKSPACE 


CTRL) CJ) 


(HOLD) or CTRL) CS) 


Function 
Stops execution of a command. 


Sends to the line printer everything 
currently displaved on the screen. 


Sends all output to the line printer, as 
well as to the screen. Press again to stop 
the function. 


Toggles echoing of output to the line 
printer. 


Removes the last character from the 
command line and erases the character 
from the displav. 


Inserts a physical end-of-line, but does 
not empty the command line. Use (CTRL 
CD) to extend the current logical line 
bevond the limits of the screen. 


Suspends the screen. Press (HOLD) or (CTRL 
CQ) to resume scrolling. 
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Key(s) Function 
Voids the current line and empties the 
or (CTRL) CX_) command line. It then outputs a 


backslash (\), carriage return, and line 
feed. The template used by the special 
editing commands is not affected. 
Although the system prompt is not 
displayed, the system is ready for a 
command. 


om 


Section II 
Commands Reference 


This section contains an alphabetical listing of all MS-DOS 
em commands, including regular and batch commands. 


The commands are: 


BACKUP EXIT RECOVER 
BREAK FIND REM 
CHDIR FOR RENAME 
CHKDSK FORMAT — RESTORE 
CLS GOTO RMDIR 
COMPDUPE HFORMAT SET 
COPY IF SHIFT 
CTTY MKDIR SORT 
DATE MORE SYS 
DEL (ERASE) PATH TIME 
DIR PAUSE TYPE 
DISKCOPY PRINT VER 
ECHO PROMPT VERIFY 
ro VOLUME 


The listing also includes a discussion of the MS-DOS file 
comparison utility, FC. 


Entry Organization 


Each entry begins with the command name and type 
(internal or external). 


Next is the command “syntax.” Use this as vour guide to 
type in the command. (See the “Syntax Notation” section 
below.) 


A brief description of the command’s function follows the 
syntax. This includes any precautions you should take 
when using the command. 


Next is the “parameters” section. This provides additional 
information about how to customize the.command for 


=, your Own purposes. 


Sample uses and examples follow the parameters. For 
your convenience, some entries include additional re- 
marks and error information. 
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Syntax Notation 


Acommand’s syntax tells you what format to use when you 
type the command. For your convenience, the following 
notations are used in the command syntax and text refer- 
ring to the commands: 


UPPER-CASE 

indicates keywords (material that you must type). You may 
type the keywords in any combination of upper- and 
lower-case letters. MS-DOS interprets them as upper-case. 


EYBOARD CHARACTER 
indicates a key you press. 


lower-case italics 

represent words, letters, characters, or values that you 
supply. 

[ ] (square brackets) 


indicate optional parameters. Do not include the brackets 
when typing the command. 


... (ellipsis) 
indicates that you may repeat a parameter as many times as 
you want. 


Type all other punctuation exactly as shown in the syntax 
line. 


Synonymous Keywords 


Some commands give you a choice of keywords. For 
example, you may type either DEL or ERASE when delet- 
ing files. Similarly, you may shorten MKDIR to MD. The 
command does the same thing, regardless of the keyword 
form. 


A Special Note to Hard Disk Users 


Even though your system has only one physical floppy 
disk drive (Drive A), you can enter most commands as you 
would on a multi-floppy system. This is because your 
system includes a logical floppy drive (Drive B). 
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When you enter commands, think of Drive A and Drive B 
as referring to disks, rather than to drives. 


Suppose you want to copy the file Myfile.dat from the 
current directory of one floppy disk to the home directory 
of another floppy disk. Think of the source disk as the 
Drive A disk and the target disk as the Drive B disk. At the 
system prompt, type 


COPY Myfile.dat B:Myfile.dat 


Because you specify Drive B (B:Myfile.dat) immediately 
after MS-DOS uses the Drive A disk (Myfile.dat), MS-DOS 
prompts you to insert the disk for Drive B. When it does so, 
remove the Drive A disk from Drive A and insert the 
Drive B disk. Press to continue. 


Remember, the system prompt represents the current 
drive. It does not represent the last disk used. 
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BACKUP 


External 


BACKUP [pathname] drive [/S] [/M] [/A] 
[/D:mun/dd/yy] 


Parameters: 


Sample Use: 


(HARD DISK ONLY) Copies (“backs up”) one or more 
files from a hard disk to floppy disks (“diskettes”). 


To use files that are on backup diskettes, you must use the 
RESTORE command to copy them back to hard disk. Do 
not try to use them otherwise. 


If, for some reason, you want to stop in the middle of 
backing up, press CTRL) CC_). 


pathname specifies the file you want to back up. 
drive specifies the disk to receive the files. 


/S causes BACKUP to copy all files in the specified direc- 
tory and all directories below it. 


/M causes BACKUP to copy only those files that have been 
modified since the last backup. 


/A tells BACKUP to add the files (to be backed up) to the 
diskette already in the specified drive, rather than prompt- 
ing you to insert a new diskette. 


If you omit the /A parameter, BACKUP asks you to insert a 
diskette. Then, before backing up any hard disk files, it 
erases any existing files on the diskette. When the diskette 
is filled, BACKUP asks you to insert another. Be sure to 
label each diskette so you know the proper order of the 
backups. 


/D:mm_-dd-yy causes BACKUP to copy only those files 
created on or after the specified date. 


Loss of information stored on hard disk, although not 
likely, can be disastrous — simply because of the amount 
of information. Therefore, you should always keep and 
update floppy diskette copies of all hard disk information. 
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Suppose you want to back up all the files in the current 
directory. First, use the FORMAT command to prepare 
several diskettes for information storage. Then insert the 
first formatted diskette into Drive A and type 


BACKUP *.* A: 


Whenever it fills a diskette, BACKUP prompts you for 
another. Suppose that later you want to add the hard disk 
file Invntory.dat to the backup diskette. Assume the file is 
in the current directory; type: 


BACKUP invntory.dat A: /A 


Note: If you have several files to back up, you may want to 
create a batch file consisting of the necessary backup 
commands. Then you can do all the backups simply by 
running the batch file. 


BACKUP *.bat A: 


backs up all batch (.bat) files from the current directory to 
Drive A. This command erases any existing files on the 
diskette before copying files to it. 


BACKUP C:STORE1 \sales.dat A:/A 


backs up the file Sales.dat that is in the STORE1 directory 
on Drive C to the diskette in Drive A, without erasing the 
diskette’s existing files. 


BACKUP *.* A:/M 


backs up (to the diskette in Drive A) all files in the current 
directory that have been modified since the last backup. 


BACKUP C:\ A:/S 


backs up (to the diskette in Drive A) all files in all direc- 
tories on Drive C. 
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BREAK 


Internal 


BREAK [ONIOFF] 


Parameters: 


Sample Use: 


Example: 


Turns the (CTRL) CC_) check on or off. 


BREAK applies only when an application program is ex- 
ecuted; it does not apply at the MS-DOS command level. It 
also does not apply to BASIC programs. 


Specifying BREAK ON tells MS-DOS to check for 
C€_) from the keyboard whenever an application pro- 
gram makes any type of MS-DOS function call. Specifying 
BREAK OFF tells MS-DOS to check for a CC_) only 
when a screen, keyboard, printer, or serial port function 
call is made. 


Suppose you are about to run an application program that 
uses the (TRL) CC_) function key. Type 


BREAK OFF 


at the MS-DOS prompt. This turns off the MS-DOS (€TRL 
C€) check. Now, whenever you press CTRL) CC), you 
affect your program instead of the operating system. 


When you finish running your application program, and 
you are using MS-DOS, type 


BREAK ON 


BREAK (ENTER 
displays the current setting of CTRL) CC_). 
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CHDIR (Change Directory) Internal 


CHDIR [ pathname] 
CD [pathname] 


Parameters: 


Changes the current directory, or the home directory 
of the specified drive, to the directory specified by 
pathname. CHDIR also verifies the current directory. 


If you are changing the current directory, pathname must 
be another directory on the current disk. 


Ifyou are changing the home directory ofa disk other than 
the current disk, you must specify the drive that contains 
the directory. pathname must be another directory on that 
disk. 


If you omit the pathname, MS-DOS displays the pathname 
of your current directory. This lets you verify a directory 
change. It also helps in case you forget the name of the 
directory. 


Sample Uses: 


Entering Commands. By changing directories, you can 
save much time when entering commands. 


Suppose (1) the root directory on Drive A is your current 
directory, and (2) the root directory on Drive B is that 
drive’s home directory. Now, suppose you want to copy 
several files from the B:\USER\MEMOS to the 
A:\USER\LETTERS. If you do not change directories, you 
must type the following to copy each file: 


COPY B:\USER\ MEMOS \ filename 
A:\USER\LETTERS \ filename 


Instead, you can can change your current directory to 
\USER\LETTERS by typing 


CHDIR \USER\LETTERS 
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Then you can change your Drive B home directory to 
\USER\ MEMOS by typing 


CHDIR B:\USER\MEMOS 
Now you can copy each file by typing only 
COPY B:filename filename 


Executing Application Programs. When executing an 
application program, you are likely to store your informa- 
tion in several data files in the same directory. Therefore, it 
may be convenient to make that directory your current 
directory. 


Suppose you use a mailing list program to keep track of 
magazine subscriptions. You might create three data files: 
one sorted by your customers’ last names, another by zip 
code, and another by subscription expiration date. 


You can store all three files in a directory called 
\MAGMAIL. When running the program, make 
\MAGMAIL your current directory. Then you can quickly 
access and transfer data between files. 


Hard Disk Users: Because you are likely to store several 
application programs on your hard disk, you may want to 
put each in a separate directory (See MKDIR). For exam- 
ple, you may want to store an Accounts Receivable pro- 
gram in a directory called \AR. When you are ready to 
use the program, use CHDIR to make \AR your current 
directory. 


Writing Application Programs. By including a CHDIR 
command when you write an application program, you 
can avoid having to manually change directories when you 
run the program. 


Suppose you write the mailing list program described 
above. You can have the program create the \MAGMAIL 
directory the first time you run the program (see MKDIR). 
Then you can have it make \MAGMAIL the current direc- 
tory each time you start the program. 
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_~ Examples: 


Changing Your Current Directory to Another Disk. 
You can use the CHDIR command to do this. First, howev- 
er, you must make that disk your current disk. 


Suppose you are in Drive A and your Drive B home 
directory is the root directory. You want your current 
directory to be B:\USER. At the A> prompt, type 


B: (ENTER 


MS-DOS puts you in the root directory on Drive B and 
displays the new command ready prompt, 


B> 
Now you can change directories by typing 
CHDIR \USER (ENTER 


If you type CHDIR (ENTER), MS-DOS verifies that \USER is 
now your current directory. 


CHDIR .. 


puts you in (changes your current directory to) the 
parent directory of your current directory. 


CHDIR \ (ENTER 
puts you in the root directory of the current disk. 
CHDIR \BIN\USER (ENTER 


puts you in the directory \BIN\USER on the current 
disk. 


CHDIR 


displays the pathname of your current directory. If, for 
example, you are in the directory \BIN\USER on the 
disk in Drive B, MS-DOS displays B:\ BIN\ USER. 


CHDIR B:\USER 


changes the home directory of Drive B to \USER. 


CHKDSK 


(Check Disk) External 


CHKDSK [drive] [/F] [/V] [>pathname] 


Parameters: 


Checks the directory of the Tandy MS-DOS disk in the 
current or specified drive for errors. You should run 
CHKDSK occasionally on each disk. 


CHKDSK doesn’t prompt you to insert the disk; it assumes 
the disk is in the drive. 


After checking the directory, CHKDSK displays the proper 
error messages, if any, and then a status report. 


Here is a sample report. The numbers vary. 


737280 bytes total disk space 
40960 bytes in 2 hidden files 
512 bytes in 2 directories 
34560 bytes in 8 user files 
661248 bytes available on disk 


131072 bytes total memory 
105038 bytes free 


Note: The report includes two hidden files. These are the 
system files, which are IO.SYS and MSDOS.SYS. You 
cannot see these files when you use the DIR command. 


If vou wish, you may redirect the output from CHKDSK to 
a file. 


pathname specifies the file to which CHKDSK is to re- 
direct its output. Do not use this parameter if you use the 
/F parameter. 


/F tells CHKDSK to correct (fix) any errors it can and 
update the disk. Do not use this parameter if you include a 
pathname. 


/V causes CHKDSK to display messages while it is running 
and gives detailed information about any errors it finds. 
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Sample Use: 


- Be sure to run CHKDSK before storing information on an 
old or frequently used disk. 


Remarks: 


The /F parameter corrects the following errors automati- 
cally: 


Invalid sub-directory entry 


Cannot CHDIR to filename 
Tree past this point not processed 


First cluster number is invalid 
entry truncated 


Allocation error, size adjusted 
Has invalid cluster, file truncated 


The /F parameter does not correct the following errors. 
_ You must correct them. 


Invalid drive specification 
Use a valid drive specification. 


Invalid parameter 
Use valid parameters only. 


Disk error reading FAT 
Use the COPY command to copy all files to 
another disk. 


Disk error writing FAT 
Use the COPY command to copy all files to 
another disk. 


Incorrect DOS version 


Insufficient memory 
Processing cannot continue 


There is not enough memory to run CHKDSK for 
this disk. You must obtain more memory. 
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Errors found, F parameter not specified 
Corrections will not be written to disk 


Specify the /F switch to correct the errors. 


Invalid current directory 
Processing cannot continue 


Restart the system and re-run CHKDSK. 


Cannot CHDIR to root 
Processing cannot continue 


The disk you are checking is bad. Restart the system and 
try using RECOVER command. 


filename is cross linked on cluster 


Make a copy of the file you want to keep; then delete 
both cross-linked files. 


x lost clusters found in y chains 
Convert lost chains to files (Y/N)? - 


If you have specified the /F switch and you type Y (ENTER), 
CHKDSK creates a directory entry and a file in which you 
can resolve this problem (files created by CHKDSK are 
named FILEnnnn.CHK). CHKDSK displays: \ bytes disk 
space freed. If you have not specified the /F switch, 
CHKDSK frees the clusters and displays: X bytes clisk space 
would be freed; it does not create a directory entry and 
file. 

Probable non-DOS disk 

Continue (Y/N)? 


You are not using an MS-DOS disk. Type Y (ENTER) to 
continue processing or N (ENTER) to stop processing. 


Insufficient room in root directory 
Erase files in root and repeat CHKDSK 


CHKDSK cannot process until you delete files in the root > 
directory. 


Unrecoverable error in directory 
Convert directory to file (Y/N)? 
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Examples: 


If you type Y (ENTER), CHKDSK converts the bad direc- 
tory into a file. You can then fix the directory or delete it. 
lf you type N (ENTER), the directory becomes unusable, 
and you can neither fix nor delete it. You should always 


type Y (ENTER). 


CHKDSK /F 


checks the directory of the current disk, displays the 
errors, asks if you want to fix them, and acts accordingly. 


CHKDSK B: /V 


checks the directory of the disk in Drive B, displaying the 
name of every directory and file on the disk, and reports 
on its progress. MS-DOS asks if you want to fix any errors. 
It cannot do so, however, until you specify the /F switch. 


CHKDSK B: >\USER\TOM \errors 


checks the directory of the disk in Drive B and outputs any 
errors to the file Errors in the \USER\ TOM directory that 
is on the current disk. MS-DOS asks if you want to fix any 
errors. It cannot do so, however, until you specify the /F 
switch. 


CLS (Clear Screen) Internal 
CLS 


Clears the screen. 


The CLS command causes MS-DOS to send the ANSI 
escape sequence ESC[2J to your screen, thus clearing it. 


Sample Use: 


After you enter two or three commands, your screen 
becomes cluttered and, therefore, hard to read. Whenever 
this happens, use the CLS command. 


Example: 
CLS 
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COMPDUPE 
(Compare/Duplicate) External 


COMPDUPE [/D] [/S] 


(FLOPPY DISK ONLY) Makes a mirror-image copy of the 
floppy disk in Drive A onto the disk in Drive B and com- 
pares the disks (duplication mode), or only compares the 
disks (comparison mode). Unlike the COPY command, 
COMPDUPE copies all information on a disk. 


You can choose whether you want MS-DOS to format the 
Drive B disk during the duplication. 


Immediately after you enter the COMPDUPE command, 
MS-DOS displays a screen similar to the following (the 
message varies slightly, depending on the mode chosen): 


When ready press the SPACE bar, or to abort press CONTROL-C 
After you press (SPACEBAR), a dashed line is displayed: 


Each dash in the dashed line represents a track. During the 
comparison or duplication, MS-DOS replaces each dash 
with one of the following symbols: 


* = source disk track read with no errors 

» = track duplicated or compared with no errors 

S = track error reading the source disk (Drive A) 

F = track error formatting the destination disk 
(Drive B) 

D = track error writing to the destination disk 

C = track error (source does not compare to 
destination) 


Note that COMPDUPE prompts you to insert the disks. If 
the disks already are in the drives, simply press 


SPACEBAR). 


When the comparison or duplication is complete, COMP- 
DUPE displays a message, asking if you want to do another. 
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Parameters: 
/D enters the command’s duplication mode. -— 


/S causes MS-DOS to skip formatting while duplicating. 
This makes the duplication faster. Ifyou omit the /S option, 
MS-DOS formats the Drive B disk while duplicating. Do 
not include the /S parameter if you don’t include the /D 
parameter. 


Omitting both parameters enters the command's com- 
parison mode. 


Sample Uses: 


By using COMPDUPE to duplicate your MS-DOS system 
dis<, you can create another operating system disk. To do 
so, insert your MS-DOS disk into Drive A and a blank disk 
into Drive B. Then, at the A > prompt, type 


COMPDUPE /D 


We suggest that you make copies of all your disks — -o 
especially your system disk and application program disks 

—and store your originals in a safe place. This reduces the 
possibility of losing information should something hap- 

pen to the disk you are using. 


If your destination disk already is formatted under MS- 
DOS, you can save time by skipping formatting during 
duplication. Before entering the COMPDUPE command, 
however, use the DIR command to make sure you don't 
need any information on the disk. Then type 


COMPDUPE /D /S 
Examples: 
COMPDUPE 
compares the Drive A and B disks, track by track. 
COMPDUPE /D 


formats the Drive B disk and makes a mirror-image dupli- 
cate of the Drive A disk onto it. 
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COMPDUPE /D /S 


makes a mirror-image duplicate of the Drive A disk onto 
the Drive B disk, which was formatted before the 
COMPDUPE command was entered. 


If no error occurs, MS-DOS displays a message to that 
effect. 


If any error occurs, in either COMPDUPE mode, MS-DOS 
displays this message: 


Disks do not compare 


The following errors cause MS-DOS to abort COMPDUPE 
and to return to the command ready prompt: 


Bad switch syntax 


You used an invalid switch syntax (such as /S only) or a 
switch other than /D or /S. 


Destination disk format error 


An error occurred during formatting. The disk may 
be “bad” or you may have inserted it in the drive 
incorrectly. 


If you are duplicating, the following errors cause MS-DOS 
to abort COMPDUPE and to return to the command ready 
prompt. 


If you are comparing, they change the track status indica- 
tor to the appropriate character (S, F, D, or C) and do not 
display an error message. 


Destination disk read error 
Destination disk write error 


Source disk read error 
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COPY 


Internal 


COPY source pathname [target pathname] 


[/A] [/B] [/V] 


Parameters: 


Copies one or more files (1) to the same directory (as the 
source), giving the new file a different filename, or (2) to 
another directory, giving the new file the same or a dif- 
ferent filename. In the second case, the target directory 
may be on any disk. 


By varying the syntax of COPY slightly, you can also use it 
to: 


* “Append” one or more files to the end of an existing file, 
keeping the target file’s filename. 


* “Combine” files into a new file that has a unique file- 
name. 


(See COPY/APPEND and COPY/COMBINE for more in- 
formation on these uses of COPY.) 


If you omit the filename from the target pathname, MS- 
DOS assumes you want to give the new file the same 
filename as the source file. 


/A, when used with a source file, tells MS-DOS to treat 
the file as an ASCII file (also called a “text” or “data” file). 
MS-DOS copies only the information up to the first end-of- 
file (EOF) character. 


/A, when used with the target file, tells MS-DOS to add 
an EOF character to the end of the file. 


/B, when used with a source file, tells MS-DOS to treat 
the file as a binary file, such as a program file. Therefore, 
MS-DOS copies the entire file. 


/B, when used with the target file, tells MS-DOS to not 
add an EOF character to the end of the file. 


Each of these switches (/A and /B) affects the file im- 
mediately preceding it in the command line and all files 
following (up until the file preceding the next switch). 


64 


) 


lan 


Section II / Commands Reference 


For example, if you type this: 
COPY thisfile /A thatfile 


the /A parameter affects both files. However, if you type 
this: 


COPY thisfile /A thatfile /B (ENTER 
the /A parameter affects only the file Thisfile. 


If you omit the /A and /B switches, MS-DOS uses /B. 
Notice that this default is the opposite of that for the 
COPY/APPEND and COPY/COMBINE commands. 


/V tells MS-DOS to verify that the sectors written to the disk 
are recorded properly. This parameter causes the copy to 
run more slowly because MS-DOS must check each entry 
recorded on the disk. 


Sample Uses: 


Copying a File to Another Disk. There are several 
reasons you may want to copy a file to another disk. Here 
are a few: 


* To give the file to someone else. 


* To create a “backup” copy of the file, without using 
COMPDUPE to duplicate the entire disk. 


* To reduce file “fragmentation” (to make files con- 
tiguous again). Fragmentation, which occurs when you 
do much creating and deleting, wastes disk space. 
Copying the files to another disk is the only way to 
reduce fragmentation. 


Remember, the target disk must be formatted and the 
target directory must exist. 


Suppose you are in A:\USER on Drive A and the file 
Personel.dat is in that directory’s parent directory (the 
root directory on Drive A). Suppose also that \USER is 
your home directory on Drive B. You can copy the file by 
typing 

COPY . .\personel.dat /A B: . . (ENTER 
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MS-DOS copies the file from A:\ to B:\. 


Suppose you have a disk containing several fragmented __, 
data files. To reduce fragmentation, copy all files to ‘ 3 
another disk. Use this command: 


COPY ~«.* /A B: (ENTER 
MS-DOS copies all files from A:\ to B:\. 


Transferring External Commands to Another 
Directory. When you receive your system disk, all exter- 
nal commands are in the root directory. As you become 
more familiar with MS-DOS, you may want to tailor your 
directory structure to your own needs. Therefore, you 
may want to move some of these commands to their own 
directory. 


Assume that you always use your system disk in Drive A 
and that you are currently in the root directory on that 
disk. Use the MKDIR command, as follows, to create the 
directory \BIN on your system disk: om 


MKDIR \BIN 


Then copy all command files except COMMAND.COM 
into \BIN. For example, to copy the FORMAT.COM file, 
type 

COPY format.com \BIN (ENTER 


MS-DOS copies the file from the current directory to the 
\BIN directory, keeping the filename the same. 


Now you can use the PATH command to tell MS-DOS to 
search A:\BIN, as well as A:\, for your external com- 
mands. To do so, type 


PATH A:\BIN 


You may now erase the copied commands from the root 
directory. Since you are still in that directory, you need on 
specify only the filename (not the entire pathname). For ' 
example, to erase FORMAT.COM, type 


ERASE format.com 
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MS-DOS erases the command from the current directory 
(the root directory) only. The file still exists in the \BIN 
directory. 


COPY memos.txt /A B:corr.txt 


copies the file Memos.txt from the current directory to the 
home directory of the disk in Drive B, naming the new file 
Corr.txt. MS-DOS copies information only up to the first 
EOF character and adds an EOF character to the end of the 
new file. 


COPY B:taxes83.dat /A taxes84.dat (ENTER) 


copies the file Taxes83.dat from the home directory in 
Drive B to the current directory, naming the new file 
Taxes84.dat. MS-DOS copies information only up to the 
first EOF character and adds an EOF character to the end 
of the new file. 


COPY prog.exe B:prog1.exe 


copies the file Prog.exe that is in the current directory to 
the home directory of Drive B. MS-DOS does not add an 
EOF character to the end of the new file, Progl.exe. 


COPY «.Ist /A combin.prn 


finds all files that have the extension .Ist (in the current 
directory) and copies them to the new file Combin.prn in 
the current directory. MS-DOS copies information only up 
to the first EOF character and adds an EOF character to the 
end of the new file. 


You cannot copy a file onto itself. (You cannot copy it to 
the same directory, giving it the same name.) 


For example, this command causes MS-DOS to abort the 
copy: 


COPY B:memos B:memos (ENTER 
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This one also causes the COPY to abort. You are trying to 
copy the file Memos that is in the current directory to 
another file Memos, also in the current directory. 


COPY memos (ENTER 
MS-DOS displays the error message 


File cannot be copied onio itself 
0 File(s) copied 
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COPY/APPEND Internal 


COPY target pathname + source pathname!1 
[+ source pathname2.. . | [/A] [/B] [/V] 


Adds one or more files to the end of another existing file. 
The files are added in the order in which you list them. 


Suppose you have these files in your current directory: 


Biglist List1 List2 

Bob Anthony Anne Barnes Jerry Day 
Carol Apple Ted Erickson Karen Ellis 
Curtis Kelly Mike McAdam Jennifer Peters 
Susan Leonard Dave Shultz Larry Thomas 


If you type this command: 

COPY biglist + list! + list2 
the new contents of the file Biglist are 
Biglist 

Bob Anthony 

Carol Apple 

Curtis Kelly 

Susan Leonard 

Anne Barnes 

Ted Erickson 

Mike McAdam 

Dave Shultz 

Jerry Day 

Karen Ellis 


Jennifer Peters 
Larry Thomas 


When you append files, the original source files still exist 
separately. The information from them is copied, not 
moved. 


Parameters: 


/A, when used with a source file, tells MS-DOS to treat 
the file as an ASCII file (also called a “text” or ‘‘data” file). 
MS-DOS copies only the information up to the first end-of- 
file (EOF) character. 
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/A, when used with the target file, tells MS-DOS to add 
an EOF character to the end of the file. 


/B, when used with a source file, tells MS-DOS to treat 
the file as a binary file, such as a program file. Therefore, 
MS-DOS copies the entire file. 


/B, when used with the target file, tells MS-DOS to not 
add an EOF character to the end of the file. 


Each of these switches (/A and /B) affects the file im- 
mediately preceding it in the command line and all files 
following (up until the file preceding the next switch). 


For example, if you type this: 
COPY onefile.txt /A + myfile.txt + samfile.txt (ENTER 


the /A parameter affects all three files. However, if you type 
this: 


COPY onefile.txt /A + myfile.txt /B + samfile.txt 
¢ 


the /A parameter affects only the target file, Onefile.txt. 


If you omit the /A and /B switches, MS-DOS uses /A. 
Notice that this default is the opposite of that for the 
regular COPY command. 


/V parameter tells MS-DOS to verify that the sectors writ- 
ten to the disk are recorded properly. This parameter 
causes the copy to run more slowly because MS-DOS must 
check each entry recorded on the disk. 


Sample Use: 


Use this command to append information to existing data 

files. Suppose, for example, that you have these files in the 
current directory: Gizmo.dat, Widget.dat, and Invntory- 

.dat. Each of the first two files contains information on a 

new product. The last contains information on all your om 
products. Type 


COPY invntory.dat + gizmo.dat + widget.dat 


to append Gizmo.dat and Widget.dat to Invntory.dat. 
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COPY B:read.dat + write.dat + print.dat (ENTER) 


appends the files Write.dat and Print.dat that are in the 
current directory, to the file Read.dat that is in the home 
directory of Drive B. MS-DOS adds an EOF character to the 
end of Read.dat. 


COPY big.Ist + «.|st 


appends all files that have the extension .Ist (except 
Big.Ist) and that are in the current directory to the file 
Big.Ist that also is in the current directory. MS-DOS adds 
an EOF character to the end of Big.1st. 


COPY prog1.exe /B + prog2.exe 


appends the file Prog2.exe that is in the current directory 
to the file Progl.exe that also is in the current directory. 
MS-DOS copies only information up to the first EOF char- 
acter in each file. MS-DOS does not add an EOF character 
to the end of Prog2.exe. 
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COPY/COMBINE Internal 


COPY source pathname! 
[+ source pathname2... | 
target pathname [/A] [/B] [/V] 


Parameters: 


Combines any number of source files into a target file that 
has a unique filespec. (The target file is new.) The files are 
added in the order in which you list them. 


Suppose you have these files in your current directory: 


Oldiist1 Oldlist2 

Anne Barnes Jerry Day 

Ted Erickson Karen Ellis 
Mike McAdam Jennifer Peters 
Dave Shultz Larry Thomas 


If you type this command: 
COPY oldlisti + oldlist2 newlist ENTER 


MS-DOS creates the file Newlist in the current directory. 
The file contains the names shown here: 


Newlist 


Anne Barnes 
Ted Erickson 
Mike McAdam 
Dave Shultz 
Jerry Day 
Karen Ellis 
Jennifer Peters 
Larry Thomas 


When you combine files, the original source files still exist 
separately. The information from them is copied, not 
moved. 


/A, when used with a source file, tells MS-DOS to treat 
the file as an ASCII file (also called a “text” or “data” file). 
MS-DOS copies only the information up to the first end-of- 
file (EOF) character. 
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/A, when used with the target file, tells MS-DOS to add 
an EOF character to the end of the file. 


/B, when the used with a source file, tells MS-DOS to 
treat the file as a binary file, such as a program file. 
Therefore, MS-DOS copies the entire file. 


/B, when used with the target file, tells MS-DOS to not 
add an EOF character to the end of the file. 


Each of these switches (/A and /B) affects the file im- 
mediately preceding it in the command line and all files 
following (up until the file preceding the next switch). 


For example, if you type this: 
COPY myfile.txt /A + salfile.txt onefile.txt (ENTER 


the /A parameter affects all three files. If, however, you 
type this: 


COPY myfile.txt /A + salfile.txt /B onefile.txt (ENTER 
the /A parameter affects only Myfile.txt. 


If you omit the /A and /B switches, MS-DOS uses /A. 
Notice that this default is the opposite of that for the 
regular COPY command. 


/V tells MS-DOS to verify that the sectors written to the disk 
are recorded properly. This parameter causes the copy to 
run more slowly because MS-DOS must check each entry 
recorded on the disk. 


Warning: Never combine files into a target file that has 
the same name as an existing file. Instead, append other 
files to the existing file. 

For example, suppose your current directory contains the 
files A.lst, B.lst, and All.lst. Do not enter this command: 
CoPy *.|st /B all.lst (ENTER 

If you do, COPY combines A.lst and B.Ist into the All.Ist 
target file, which replaces (destroys) the All.Ist source file. 
Then COPY displays the message “Content of destination 
lost before copy.” 
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Sample Use: 


Examples: 


Suppose you have two files, Phone4.dat and PhoneS.dat, 
each of which contains a list of phone extensions for 
personnel on a particular floor. As your company grows, 
however, you must move all these people to the ninth 
floor. Rather than type in all the information again, you can 
combine the two files into a new file. To do so, type 


COPY phone4.dat + phone5.dat phone9.dat 


Now you can sort your new file alphabetically, using the 
SORT command (see SORT). 


COPY B:memos.txt + B:letters.txt B:corr.txt (ENTER 


combines the files Memos.txt and Letters.txt that are in the 
home directory on Drive B. COPY copies information only 
up to the first EOF character in each source file. Then it 
places the information in the new file Corr.txt in the same 
directory and adds an EOF character to the end of that file. 


COPY A:\stats1.dat + A:\stats2.dat B:\allstats.dat 
ENTER 


combines all information from the files Statsl.dat and 
Stats2.dat that are in the root directory of Drive A. Then 
COPY places the information in the new file Allstats.dat in 
the root directory of Drive B. MS-DOS adds an EOF charac- 
ter to the end of Allstats.dat. 


COPY a.com + b.com + B:c.com oneprog.com /B 


combines the files A.com and B.com that are in the current 
directory, with the file C.com that is in the home directory 
of Drive B. COPY copies information only up to the first 
EOF character in each source file. Then it places the 
information in the new file Oneprog.com in the current 
directory. It does not add an EOF character to the end of 
that file. 
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CTTY (Change I/O Device) Internal 
CTTY device 


~~ 


Parameters: 


=~ Examples: 


Changes the input/output (I/O) device to the device 
specified. 


Normally, input comes from the keyboard and output 
goes to the screen. 


The device can be either of the following: 


* AUX specifies an auxiliary device, such as a disk drive. 
To tell MS-DOS which device is your auxiliary, you must 
use CONFIG.SYS (see Appendix C, “How to Configure 
Your System.”). 


* CON specifies the console (input from the keyboard 
and output to the screen). 


It cannot be LST or PRN (list or print), however, because 
the printer is not capable of input. 


CTTY AUX 


moves all command input/output (J/O) from the current 
device to the auxiliary device. 


CTTY CON 


changes the input device to the keyboard and the output 
device to the screen. 
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DATE 


Internal 


DATE [mm/dd/yy] 


Parameters: 


Enters or changes the date known to the system. This date 
is recorded in the directory for any files you create or 
change. You can also use this command to display the 
current date. 


You can change the date from the keyboard or from a 
batch file. (Normally, MS-DOS displays a date prompt each 
time you Start up your system. It does not, however, if you 
use an Autoexec.bat file. Therefore, you may want to 
include a DATE command in that file.) 


Note: MS-DOS is programmed to change the months and 
years correctly, taking into account leap years and the 
number of days in the months. 


mm-dd-yyyy specifies the date in numerical form. 
* mm (month) is a 1- or 2-digit number from 1-12 
¢ dd (day of month) is a 1- or 2-digit number from 1-31 


* yyyy (year) is a 2-digit number from 80-99 (1900 is 
assumed) or a 4-digit number from 1980-2099 


Note: If the month or day is less than 10, you may include a 
leading zero (for example, 09/09/84). However, this is not 
necessary. When MS-DOS stores and displays the date, it 
includes a leading zero in a 1-digit day and excludes it 
from a 1-digit month (for example, it stores 9/09/1984). 


You may separate the date, month, and year with either 
slashes or hyphens. 


If you omit the m-dd-yyyy parameter, DATE displays the 
current date and asks you to enter the new date. If you 
don’t want to change the date, press (ENTER). If you do want 
to change it, enter it in the mm-dd-yyyy format. 


Sample Uses: 


When you change the date known to the system, you also 
change the date in any application program you use. This 
can be very handy. 
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Suppose that you have a program that keeps track of 
purchase orders according to the date received. For some 
reason, you get behind and can’t enter the information on 
that date. Simply enter it later, after “turning back the 
calendar” to the necessary date. 


You can also use DATE and TIME to include the date and 
time on a printout. For example, press or 
CP_) to send all output to the line printer, as well as to the 
screen. Then type 


DATE 
TIME 


Press (PRINT) again to turn off the “print output” function. 
Now use (SHIFT) (PRINT), (PRINT), CTRL) P, or the PRINT 
command as necessary to make your printout. 


DATE 


displays the current date and prompts vou for the new 
date. For example, if the date is July 7, 1984, MS-DOS 
displays: 


Current date is Sat 7-07-1984 
Enter new date: 


You may now change the date or press (ENTER) to bypass 
the prompt. 


DATE 11/15/1984 


enters the current date as Thursday, November 15, 1984. 


If the options or separators aren’t valid, DATE displays the 
message 


Invalid date 
Enter new date: 


It then waits for you to enter a valid date. 


DEL (Delete) Internal 


See the ERASE command. 
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DIR (Directory) Internal 
DIR [ pathname]|/P][/W] 


Displays (1) information about all files or the specified 
files that are in the current directory or in the directory 
specified by pathname, or (2) information about the one 
file specified by pathname. 


First, MS-DOS displays the disk’s volume label, which was 
assigned during formatting. If you did not assign a label, 
MS-DOS displays a message to that effect. 


Then MS-DOS lists each file with its size (in bytes) and the 
time and date of the last modification. It then gives the 
number of files listed and the number of bytes remaining 
on the disk. 


Here is a sample listing for all files that are in B:\ USER: 
Volume in drive B has no label 


Directory of B:\user 


6-24-83 12.36a 
6-24-83 12.36a 
MAILSRT BAT 252 6-28-83 12.42a 
TEST2 TST 1512 6-28-83 12.56a 


INVNTORY = DAT 6759 6-30-83 8.45a 
PERSONEL DAT 5094 6-30-83  5.08p 
® File(s) 691794 bytes free 
Here is a sample listing for the file Mailsrt.bat that is in 

B:\USER: 

Volume in drive B has no label 

Directory of B:\user 

MAILSRT BAT 1512 6-28-83 12.42a 
1 File(s) 691794 bytes free 
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Parameters: 


If you omit the pathname, MS-DOS lists the directory 
entries for all files that are in the current directory. (If the 
disk contains only one directory, MS-DOS lists all files on 
the disk.) You may use the MS-DOS wild cards in the 
pathname. 


/P selects the “page” mode. With /P, display of the di- 
rectory pauses when the screen is filled. It displays this 
message: 


Strike a key when ready... 
To resume display of output, press (SPACEBAR). 


/W selects a wide display. With WW, MS-DOS displays file- 
names only; it does not display the files’ sizes or modifica- 
tion dates. 


Sample Uses: 


You can use the DIR command to see how much space one 
file takes and how much free space remains on a disk. 
Suppose you want to see how much — space 


B:\USER\ mailsrt.bat takes and how much space remains 
on Drive B. Type 


DIR B:\ USER \mailsrt.bat 


Use DIR when you forget the name ofa file. For example, if 
you are in Drive A and need to know the name of a file in 
Drive B, type 

DIR B:\ (ENTER 


The backslash indicates the root directory. If you do not 
use it, MS-DOS lists the files in the home directory. If the 
file you want is not in the root directory, use the DIR 
command as needed to check the subdirectories. 

You may want to index your disk by printing the directory 
listing. To do so, press (PRINT). Then type 


DIR (ENTER 
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Pressing (PRINT) causes MS-DOS to send all output to the 
printer, as well as to the screen, until you again press 


PRINT). 


DIR B: (ENTER 
displays a list of all files in the home directory of Drive B. 
DIR /W (ENTER 


displays, in the wide mode, the filenames of all files in the 
current directory. 


DIR \USER\*.bat /P 


displays a list of all batch files in the \USER directory on 
the current drive. MS-DOS halts (“pauses”) the display 
when the screen is full. Press (SPACEBAR) to continue. 


DIR A:\USER\ACCT.* 


displays a list of files that have the name Acct — regardless 
of their extensions — and that are in the A:\USER 
directory. 
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DISKCOPY External 


DISKCOPY [source drive] | target drive] 


Parameters: 


Copies the contents of the disk in the source drive to the 
disk in the target drive. 


DISKCOPY is similar to COMPDUPE. Unlike COMPDUPE, 
however, DISKCOPY does not do the following: 


¢ Format the target disk. You must use the FORMAT com- 
mand before using DISKCOPY. 


¢ Compare the disks. 
* Give a track-by-track analysis of the copy’s progress. 
After copying, DISKCOPY prompts: 


Copy complete 
Copy another (Y/N)?_ 


If you press CY_), MS-DOS prompts you to insert the disks. 
Then it performs the next copy, using the drives you 
specified earlier. 


If you press CN_), MS-DOS doesn’t perform another copy. 


If the source and target drives are the same, MS- 
DOS performs a single-drive copy. It prompts you to insert 
the disks at the appropriate times. Press (SPACEBAR) to 
continue. 


If you omit either drive specification, MS-DOS uses the 
current drive. 


Therefore, if you omit both drive specifications, MS-DOS 
does a single-drive copy on the current drive. (This 
assumes that the DISKCOPY.COM file is in the current 
directory, so that MS-DOS can find it, or that you use PATH 
beforehand to tell MS-DOS where to look for the file.) 


Sample Use: 


Section II / Commands Reference 


By using DISKCOPY to duplicate your MS-DOS system 
disk, you can create another operating system disk. We 
suggest that you make copies of all your disks — especially 
your system disk and application program disks — and 
store your originals in a safe place. This reduces the 
possibility of losing information should something hap- 
pen to the disk you are using. 


Ifyou have a hard disk system (only one floppy drive), type 
DISKCOPY (ENTER 

MS-DOS prompts you to insert the “Drive A” disk. Insert 
the source disk into Drive A. It then prompts you for the 
“Drive B” disk. Remove the source from Drive A and insert 
the /arget. Press (SPACEBAR). MS-DOS continues to prompt 
you, as necessary. 

If you have a floppy disk system (two floppy drives), type 
DISKCOPY A: B: (ENTER 

MS-DOS copies all information from the disk in Drive A to 
the disk in Drive B. 

Floppy disk users: DISKCOPY is also the command to use 


to copy an entire data disk. To do this, tvpe 


DISKCOPY A: B: 
MS-DOS displays: 


Insert source diskette in drive A: 
Insert target diskette in drive B: 
Strike any key when ready 


When the drive light goes out, remove the system diskette 
from Drive A and insert the sozmrce data disk. Insert the 
target data disk in Drive B. Then press (SPACEBAR) to 
continue. 
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Examples: 


Remarks: 


Error: 


DISKCOPY 


copies all information from a disk in the current drive to 
another disk in the current drive. MS-DOS prompts you to 
insert disks, as necessary. (This example assumes that the 
DISKCOPY.COM file is in the current directory, so that 
MS-DOS can find it, or that you use PATH beforehand to 
tell MS-DOS where to look for the file.) 


DISKCOPY A: B: 


copies all information from the disk in Drive A to the disk 
in Drive B. Before starting the diskcopy, MS-DOS prompts 
you to insert disks. 


The disks must have the same number of physical sectors, 
and those sectors must be the same size. 


Files become fragmented (not contiguous) when much 
creating and deleting is done on a disk. A fragmented disk 
can cause poor performance because of delays involved in 
finding, reading, or writing a file. If this is the case, you 
must use the COPY command to reduce fragmentation. 
(See the COPY command. ) 


If MS-DOS finds disk errors during DISKCOPY, it displays: 
DISK error while reading drive A 

Abort, Ignore, Retry? 

Refer to Appendix A, “Problems and Error Messages,” for 
information on this error message. 
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ECHO Internal 
ECHO [ONIOFF| message] 


Turns the batch ECHO feature on or off. 

Normally, commands in a batch file are displayed 
(echoed) as you run the file. ECHO OFF turns off this 
feature. ECHO ON turns it on again. (Note: ECHO is 
automatically turned on again after execution of the batch 
file.) 

ECHO message displays the specified message, regardless 
of whether ECHO is ON or OFF. 


Parameters: 


If you don’t specify ON or OFF, and you omit a siessage, 
MS-DOS displays the current setting of ECHO. 


Sample Use: 


Whenever you want to protect information in a batch file, 
you can turn ECHO OFF. You can also use ECHO OFF 
when you don’t want to clutter the screen with unneces- 
sary information. 


Example: 


The following batch file formats a disk in Drive B and then 
checks the disk. (The file uses some external commands, 
so it must be created in a directory that contains the 
external commands. ) 


COPY con prepdisk.bat 

ECHO OFF 

REM This file formats and checks disks in Drive B 
ENTER 

REM It is called Prepdisk.bat 

FORMAT B: 

ECHO Do you want to check Drive B? 

PAUSE 

CHKDSK B: 

ECHO ON 


When you run the file, MS-DOS displays 


COPY con prepdisk.bat 
ECHO OFF 
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Insert new diskette for drive B: 
and strike any key when ready ... 


Formatting tracks 


nnnnnn bytes total disk space 
nnnnnn bytes available on disk 
Format another (Y/N)?n Do you want to check Drive B? 


Strike a key when ready... 


nnnnnn bytes total disk space 


nnnnnn bytes available on disk 


nnnnnn bytes total memory 
nnnnnn bytes free 


As you can see, the commands are not echoed. The 
prompt “Do you want to see the directory and check Drive 
B?” is displayed, however. This is because the ECHO 
command used here includes the message parameter. 
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ERASE 


Internal 


ERASE [ pathname] 
DEL [ pathname] 


Parameters: 


Erases (deletes) one or more files from current directory 
or from the directory specified by pathname. 


Warning: If you omit the filename from the pathname, 
MS-DOS assumes you want to erase all files in the direc- 
tory. (Using the wild card *.* as the filename is the same as 
omitting the filename.) 


If you omit the entire pathname, MS-DOS assumes you 
want to erase all files in the current directory. (Using the 
wild card *.* as the pathname is the same as omitting the 
pathname.) If the disk contains only one directory, MS- 
DOS erases all files on the disk (except . and ..). 


To avoid erasing important files, use the DIR command, 
with the appropriate wild card, beforehand to check 
which files you need. 


Sample Uses: 


By erasing unnecessary files, you can create more free 
space in a directory. Suppose you combine the files A.lst 
and B.lIst, which are in the current directory, into a new 
file, All.Ist, on a different directory. 


Assuming the current directory contains no other files that 
have the extension .lst, you may erase A.lst and B.Ist by 
typing 

ERASE *.lst 

Warning: If you include an extension, such as the .1st 
used here, MS-DOS does not prompt you before erasing 


the files, regardless of whether or not you use a wild card. 
It prompts only when you use the full wild card, *.*. 


You must erase all files in a directory (except the files . and 
..) before you can use RMDIR to remove the directory. 
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Examples: 


ERASE \BIN\USER\MARY \text.txt 


erases the file Texttxt from the — directory 
\BIN\USER\ MARY on the current disk. 


ERASE B:\USER\JOHN\*.* 


tells MS-DOS to delete all the files in the directory 
\USER\JOHN on Drive B. MS-DOS asks: Are you sure? If 
you type Y (ENTER), MS-DOS erases the files. If you type N 
ENTER), MS-DOS does not erase the files. 

ERASE B:\BIN\USER\ MARY (ENTER 


tells MS-DOS to erase all files in the \BIN\USER\ MARY 
directory on Drive B. MS-DOS asks if you are sure you 
want to do this and then acts accordingly. 


ERASE file2 


erases the file File2 from the current directory. 
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EXE2BIN 


(Executable to Binary) External 
re ete ne 
EXE2BIN source pathname [target pathname] 


Parameters: 


Converts the .exe (executable) file, specified by source 
pathname, to .com file format (binary format). 


EXE2BIN is an advanced command, recommended 
for advanced users only. 


The source file must be in valid .exe format produced by 
the linker. The resident, or actual code and data part of the 
file, must be less than 64K. There must be no STACK 
segment. 


If you don't include an extension in the source path- 
name, the extension defaults to .exe. 


target pathname specifies a file to receive the converted 
program file. Ifyou omit the drive, MS-DOS uses the drive 
specified in the source pathname. If you omit the exten- 
sion, it gives the new file the extension .bin. If you omit 
the entire target pathname, MS-DOS uses the source 
pathname. 


Kinds of Conversion: 


Two kinds of conversions are possible, depending on 
whether the initial CS:IP (Code Segment:Instruction 
Pointer) is specified in the .exe file. 


If CS:IP is not specified, EXE2BIN assumes a pure binary 
conversion. If segment fixups are necessary (the program 
contains instructions requiring segment relocation), 
EXE2BIN prompts for the fixup value. This value is the 
absolute segment at which the program is to be loaded. 


In a pure binary conversion, the resulting program is 
usable only when loaded at the absolute memory address 
specified by a user application. The command processor 
cannot properly load the program. 


If CS:IP is specified as 0000:100H, EXE2BIN assumes the 
file is to be run as a.com file with the location pointer set at 
100H by the assembler statement ORG. It deletes the first 
100H bytes of the file. It allows no segment fixups, as .com 
files must be segment relocatable. 
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Sample Use: 


Examples: 


Errors: 


When this kind of conversion is complete, you may re- 
name the resulting file, giving it a .com extension. Then 
the command processor can load and execute the pro- 
gram in the same way as the .com programs supplied on 
your MS-DOS disk. 


Converting executable files to binary format saves space 
and speeds program loading. 


EXE2BIN tesifile.exe B: 


Converts the file Testfile.exe that is in the current direc- 
tory to binary format and places the new file, Testfile.bin, 
in the home directory of Drive B. 


EXE2BIN A:\USER \oldfile.exe A:newfile (ENTER 


Converts the file Oldfile.exe that is in A:\USER to binary 
format and places the new file, Newfile.bin, in the home 
directory of Drive A. 


If CS:IP does not meet either criterion (discussed in 
“Kinds of Conversions”) — or if it meets the .com file 
criterion but has segment fixups — EXE2BIN displays the 
following message: 


File cannot be converted 


EXE2BIN also displays this message if the file is not a valid 
executable file. 


EXE2BIN may also display these error messages: 
File not found 
The file is not on the disk specified. 
Insufficient memory 


There is not enough memory to run EXE2BIN. 
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File creation error 


EXE2BIN cannot create the output file. Run CHKDSK to 
determine if the directory is full or if some other condi- 
tion caused the error. 


Insufficient disk space 
There is not enough disk space to create a new file. 
Fixups needed - base segment (hex): 


The source (.exe) file contains information that indi- 
cates that a load segment is required for the file. Specify 
the absolute segment address at which the finished 
module is to be located. 


File cannot be converted 
The source file is not in the correct format. 


WARNING -Read error on EXE file. 
Amount read less than size in header 


This is a warning message only. 
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EXIT 


Internal 


EXIT 


Sample Use: 


Example: 


Exits the program COMMAND.COM (the command pro- 
cessor) and returns to a previous level, if one exists. 


If you have exited an application program to use 


the command processor, use EXIT to return to the 
application, 


While running an application program, you may need to 
use an MS-DOS command. To do so, you must exit your 
program. 


For example, if you want to see your directory, you must 
use the MS-DOS DIR command. Type 


COMMAND 


to exit your application program and start the command 
processor. Then type 


DIR B: (ENTER 
to display the directory of the disk in Drive B. Finally, type 
EXIT (ENTER 


to return to your application program. 


EXIT (ENTER 


returns you to the previous level. 
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FC (File Comparison) Utility 


FC [/number] [/B] [/W] [/C] pathname! 
pathname2 [> target pathname] 


Compares the contents of two files, pathname and 
pathname2, and sends the output to the screen or to the 
file specified by target pathname. 


The two kinds of comparisons are: 


° Line-by-line 
° Byte-by-byte 


In a line-by-line comparison, FC marks off blocks of lines, 
and then compares the lines within each block. The “Sam- 
ple Use” section explains how FC determines where each 
block begins and ends. 


In a byte-by-byte comparison, FC simply displays the bytes 
that are different. 


Parameters: 


pathname 1 and pathname2 may be either “source 
files” (files that contain source statements of a program- 
ming language) or binary files (files output by the assem- 
bler, the linker, or a Microsoft high-level language 
compiler). 

/B forces a binary comparison of both files. The two files 
are compared byte-by-byte, with no attempt to re- 
synchronize after a mismatch. FC displays the mismatches 
as follows: 


--ADDRS----F 1----F2- 
XXXXXXXX YY ZZ 


where xxxvxxxv is the relative address of the pair of bytes 
from the beginning of the file. Addresses start at 00000000. 


yy and zz are the mismatched bytes of pathname! and 
pathname, respectively. If one file contains less data than 
the other, FC displays a message to that effect. 


For example, if pathname ends before pathname? ends, 
then FC displays 


«**Data left in pathname2*** 
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number is the number of lines that must match for the 
file to be considered as matching again after FC finds a 
difference. It can be from 1 through 9. If you don’t specify a 
number, it defaults to 3. Use this parameter only in source 
comparisons, 


/W compresses “white” spaces (tabs and spaces) for the 
comparison. Thus, if several whites are together on one 
line, FC considers them as one white space. FC ignores 
whites that are at the beginning and end of lines. 


For example (an underscore represents a white space), 
—NMore_data_to.be-found__ 

matches 

More.data_to_be_found 

and 


More. data_to_be__found. 


but does not match 
—NMoredata_to_be_found 
Use the /W parameter only in source comparisons. 


/C causes FC to ignore the case of letters. All letters in the 
files are considered uppercase letters. For example, 


Much.MORE-data_IS_NOT.FOUND 
matches 
much_more.data_is_notfound 


Use the /C parameter only in source comparisons. 
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Sample Use: 


oo Use FC when you want to determine which of two files is 
current and what changes have been made since the old 
version. 


Suppose your current directory contains these source 
files. Each letter in the files represents a program line. 


Namet1.src Name2.src 
A A 
B B 
M C 
D L 
O S 
S$ WwW 
Ww X 
X Y 
Y Z 
Z P 
a. R E 
U N 
N Q 
Q V 
T 
Vv 


To compare the files line-by-line, type 


FC /1 name1.asm name2.asm (ENTER 
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FC begins by marking off the blocks of lines. Simply put, 
whenever FC encounters a match, it ends a block. There- 
fore, FC blocks off the lines as follows: 


Name1.asm Name2.asm 
A A 
B B 
M Cc 
D L 
O S 
S 
W WwW 
Xx X 
Y Y 
Zz Z 
R P 
U E 
N N 
Q Q 
T V 
Vv 


FC ignores matching blocks that are before the first mis- 
match. It also ignores blocks in which at least the specified 
number of lines match. In this case, the zzzmber is 1. For 
each set of blocks that contains a mismatch, however, FC 
displays the following information: 


J pact bees NAME1.SRC 


2. The lines in the Namel.src block that differ from 
those in the corresponding Name2.sre block 


3. The line that is the same (the last line in the block) 


Gi eee NAME2.SRC 
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5. The lines in the corresponding Name2.src block that 
differ from those in the Namel.src block 


6. The line that is the same (the last line in the block) 


Therefore, for the files Namel.src and Name2.src, FC 
displays: 


eed NAME1.SRC 
M 
D 
O 
Ss 

aipspececeiesclind NAME2.SRC 
C 
1. 
S 

abate NAME1.SRC 
R 
U 
N 

eran eterente NAME2.SRC 
P 
E 
N 

poesia races NAME1.SRC 
T 
V 

plage easton NAME2.SRC 
V 


You can print the differences on the line printer using the 
same two source files. To do this, type 


FC name1.src name2.src >PRN 
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Examples: 


FC /B test1.src test2.src >test3.src (ENTER 


does a binary comparison of the files Testl.src and 
Test2.src that are in the current directory and redirects 
output to the file Test3.sre that is also in the current 
directory. 

FC /4 /W /C B:\USER\ myfile.src 
B:\USER\myfile1.srce 


does a line-by-line comparison of B:\USER\myfile.src 
and B:\USER\ myfile1.src, compressing white spaces and 
ignoring case. After FC finds a mismatch, at least four 
lines in a row must match for the file to be considered 
matching. 


Limitations On Source Comparisons: 


Errors: 


FC uses a large amount of memory as buffer (storage) 
space to hold the source files. If the source files are larger 
than available memory, FC compares what can be loaded 
into the buffer. Ifno lines match in the portions of the files 
in the buffer, FC displays only the message 


*““ Files are different *** 


For binary files larger than available memory, FC com- 
pares both files completely, overlaying the portion in 
memory with the next portion from disk. This does not 
affect the command output. 


If FC finds many differences (involving many lines), it only 
reports that the files are different. Then it stops. 


If it finds no matches after the first mismatch, FC displays 
*** Files are different *** 


and returns to the system prompt (for example, A>). 


98 


oo 


- 


Section II / Commands Reference 


FC may also display these messages: 
* Invalid parameter:parameter 
One switch is invalid. 
¢ File not found:pathname 
FC could not find the file you specified. 
¢ Read error in:pathname 


FC could not read the entire file. 


Invalid number of parameters 


You have specified the wrong number of parameters. 
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FIND 


External 


FIND [/V] [/C] [/N] “string” [pathname .. . | 


Parameters: 


Searches for the specified string of text in one or more 
files, which are specified by one or more pathnames. 


Capitalization and punctuation in the string must be the 
same as in the file. Otherwise, MS-DOS cannot find it. 


FIND is a filter. 


If you omit the pathname option, MS-DOS searches for the 
string among the lines on the current screen display. 


Enclose the string in quotes. For example, to find all 
occurrences of this string: 


The whiteness of the whale 


that are in the files Book1.txt and Book2.txt in the current 
directory, type 


FIND “The whiteness of the whale” book1.txt 
book2.txt (ENTER 


MS-DOS displays the lines in the order in which the files 
are specified. 


If the string contains quotations, enclose each quotation in 
double quotes. For example, to find all occurrences of this 
string: 


Aye, “Moby Dick” is a whale of a story. 
that are in the file Book1 txt in the current directory, tvpe 


FIND “Aye, “ “Moby Dick” ” is a whale of a story.” 
Book1 .txt 


/V causes FIND to display all lines that do not contain the 
string. Do not use this with the /C parameter. 


/C causes FIND to display only the number of lines (in 
each file) that contain the string. 


/N causes each line to be preceded by its relative line 
number in the file. Do not use this with the /C parameter. 
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Sample Use: 


Using FIND with the /N parameter, you can determine 
which lines contain the specified strig. Then, knowing 
the line numbers, you can easily enter the EDLIN Edit Line 
command and change every occurrence of the stig. (See 
Section HI, “EDLIN.”) 


Suppose one of your suppliers, Johnson Auto Parts, buys 
out another, Samuel Parts. You need to change all occur- 
rences of Samuel Parts to Johnson Auto Parts in your 
B:\USER\Invntory.dat file. To find the line number of 
each occurrence, type 

FIND /N “Samuel Parts” B:\ USER \invntory.dat 


MS-DOS might display a list like this: 
woeecnenee B:\user \invntory.dat 


[1]spark plugs 200 6-16-83 Samuel Parts 
[5|distributor caps 50 6-16-83 Samuel Parts 
[9]14” rad hose (2” dia.) 25 6-16-83 Samuel Parts 


Now you can use EDLIN to edit Lines 1,5, and 9 as needed. 


Examples: 


FIND /C “-” B:\USER\profits.dat 

displays the number of times a negative sign occurs in 
B:\ USER \ Profits.dat. In this way, you can see at a glance 
how many negative numbers you have in the file. (Notice 
the space after the negative sign. This is included so MS- 
DOS does not find hyphenated words. ) 

DIR B: | FIND /V “DAT” 


displays all names of the files in the home directory of the 
disk in Drive B that do not contain the string DAT, 
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Errors: 


When MS-DOS finds an error, it displays one of the follow- 
ing error messages: 


e FIND: Invalid number of parameters 
You did not specify a string. 
¢ FIND: Syntax error 
You typed an illegal string. 
¢ FIND: File not found filename 
FIND cannot find the specified filename. 
¢ FIND: Read error in filename 
An error occurred when FIND tried to read the file. 
¢ FIND: Invalid parameter parameter 


You specified a parameter that does not exist. 
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FOR 


Internal 


FOR %f IN (set) DO command %f 
(regular MS-DOS command) 


ym™ FOR %%f IN (set) DO command %%f 
(batch file command) 


Parameters: 


Executes the specified command, sequentially, for each 
item in the set. 


set may be a list of items, each of which is separated with a 
space, or it may be one wild card item. Files, directories, 
and disk drives are only a few of the items you may list. 


%f is the variable that MS-DOS uses to represent each item 
in the set, one at a time. DO tells MS-DOS to do the 
command on %f (each item). 


%%f is the same as %f, except the second per cent sign is 
required because the command is in a batch file. 


p-~ Sample Uses: 


' 


Use FOR whenever you want to execute a command for 
several items, so you don’t repeat the command unneces- 
sarily. For example, at the system level, vou may want to 
see the directory listing for three directories: A:\, B:\, and 
B:\ USER. To do so, type 


FOR %f IN (A:\ B:\ B:\USER) DO DIR %f (ENTER 
MS-DOS displays the listing for each directory, in order. 


Suppose you want to be able to substitute other directo- 
ries for those in the command above. You must use re- 
placeable parameters. Therefore, your FOR command 
must be in a batch file. Create such a file by typing 


COPY con 3dir.bat 

REM This file displays directory listings for %1, %2, 
and %3 

REM It is called 3dir.bat 

FOR %%f IN (%1 %2 %3) DO DIR %%f 
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Examples: 


Suppose you want to see the listings for A:\BIN, 
A:\ GAMES, and A:\ACCTS. To execute the batch file, type 


3dir A:\BIN A:\GAMES A:\ACCTS 


MS-DOS first substitutes the directory names, in order, for 
the replaceable parameters %1, %2, and %3. Then, it does 
a DIR command for each directory. 


FOR %f IN (*.asm) DO TYPE %f 


displays all files in the current directory that have the 
extension .asm. 


FOR %f IN (taxfile autofile homefile) DO DEL %f 


deletes the three files, in order, from the current 
directory. 
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FORMAT External 
FORMAT [drive] [/S] [/V] [/P] 


(FLOPPY DISK ONLY) Prepares the blank floppy disk in 
the specified drive for use. FORMAT does this by defining 
the tracks and sectors and writing system information onto 
the disk. 


Note: To prepare a hard disk, you must use the HHORMAT 
command. 


You can format either a blank or already formatted disk. If 
the disk already is formatted, you lose all information 
when you reformat it. 


Immediately after you enter the FORMAT command, FOR- 
MAT displays 


Insert new diskette for drive A: 
and strike any key when ready 


Note that FORMAT prompts you to insert the disk. If 
the disk is already in the drive, simply press 
SPACEBAR). FORMAT displays 


Formatting tracks 


Each dash in the dashed line represents a “track,” an area 
on the disk. As the track is formatted, MS-DOS replaces the 
dash with a period (.). A question mark (?) in place of a 
period indicates that the corresponding track contains 
flawed “sectors.” This is no problem, however, because 
FORMAT locks out flawed sectors so that MS-DOS never 
writes to them. 


When the format is complete, MS-DOS displays this mes- 
sage: 


nnnnnn bytes total disk space 
nnnnnn bytes available on disk 


Format another (Y/N)? 
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Parameters: 


Press ENTER) to format another disk in the same 
drive. Press CN_) (ENTER) if you don’t want to format 
another disk. 


drive can be either Drive A or B. 
If the drive is Drive A, MS-DOS prompts: 


Insert new diskette for drive A 
and strike any key when ready. 


Remove the system disk from Drive A and insert the disk to 
be formatted. Press (SPACEBAR) to begin formatting. 


If you omit the drive specification, MS-DOS formats the 
disk in the current drive. 


/S causes FORMAT to copy the system files (IO.SYS, 
MSDOS.SYS, and COMMAND.COM) to the disk after it is 
formatted. This makes the newly formatted disk a system 
disk. 


/V causes FORMAT to prompt for a volume label after the 
disk is formatted. If you use this parameter, you may enter 
a label of up to 11 characters, or you may press to 
bypass the prompt. Entering a volume label helps keep 
track of your disks, the same as if you affix real labels to 
them. 


/P causes FORMAT to prompt for the “skew” and “inter- 
leave” factors, which together determine the order in 
which MS-DOS is to access disk sectors. If you omit the /P 
parameter, disk sectors are accessed in order from 1 to 9. 


If you are not an advanced user, you probably are not 
familiar with skew and interleave factors. If not, we recom- 
mend that you do not use the /P parameter. 
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Examples: 


Errors: 
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Before you can store information on a new disk, you must 
prepare it using FORMAT (unless you format it while using 
the COMPDUPE command). After formatting, record the 
volume label and date of creation. Store this information 
in a safe place. It helps you estimate how long a diskette 
has been in use. 


Suppose you have an old disk you want to “start over” 
with, First, do a DIR command to make sure you don’t 
need anything on the disk. Then you can use FORMAT to 
erase all old information and lock out any flawed sectors 
that have developed. FORMAT puts the system informa- 
tion back on the disk and leaves the “good” sectors avail- 
able for information storage. 


FORMAT 

formats the disk in the current drive. 
FORMAT A: 

formats the disk in Drive A. 
FORMAT B: /S /V 


formats the disk in Drive B, makes it a system disk, and asks 
you for a volume label. You may enter a label of up to 11 
characters (for example, DISKONE), or press if 
you don’t want to label the disk. 


FORMAT /P 


formats the disk in the current drive, prompting you for 
the new skew and interleave factors. 


The following errors cause MS-DOS to abort the FORMAT 
command and return to the system prompt. 
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¢ Error writing boot sector to destination 


All floppy disks — both data and system disks — must 
have a boot sector so that they may be used by the 
system. 


After format, one of system sectors could not be 
read 


The system sectors (boot, file allocation table, and direc- 
tory) are required for the disk to be useful. 


Errors writing to the system sectors, cannot 
continue 


The system sectors (boot, file allocation table, and direc- 
tory) are required for the disk to be useful. 


108 


GOTO 


Internal 


GOTO Iabel 


Parameters: 


Sample Use: 


Transfers control to the line (in the batch file) that follows 
the one that contains :/abel. 


GOTO is a batch file command. 


label is a character string. MS-DOS considers only the first 
eight characters; it ignores the rest. 


When a batch file executes, its Jabels are not displaved. 
Therefore, you can use /abels to include comments in a 
batch file. 


Use GOTO with the IF command to direct execution to 
particular subroutines when particular conditions exist. 
(See the IF command also.) 


Using GOTO and IF, you can create a batch file that copies 
a specified source file to a specified target file only if the 
target does not already exist. If the target exists, the file 
pauses so you can abort the copy. 


Create the file by typing 


COPY con chekdest.bat 

REM Checks to see if file exists before copying to it 

REM When executing, substitute the drive for %1 
and the directory for %2 

REM When executing, substitute the source file for 
%3, the target for %4 

%1 

CHDIR %2 

IF NOT EXIST %4 GOTO G 

TYPE %4 

PAUSE 

‘G 

COPY %3 %4 

‘END 

ENTER 
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Example: 


Error: 


Suppose that Newfile.asm exists in the root directory of 
Drive B, and you execute the batch file by typing: 


chekdest B: \ oldfile.asm newfile.asm (ENTER 


As instructed in the command line, the batch file replaces 
%1 with B:, making Drive B the current drive. It then 
replaces %2 with \, making the root directory the current 
directory. Finally, it replaces %3 with Oldfile.asm and %4 
with Newfile.asm. 

The batch file checks to see if Newfile.asm exists in the 
current directory. It does; therefore, the batch file uses the 
TYPE command to display Newfile.asm. Then it pauses. If 
you want to copy over Newfile.asm, press (SPACEBAR). If 
not, press CC). 

If Newfile.asm does not exist in the directory, the batch file 
“goes to” the line following :G. Therefore, it does the copy 
automatically, without pausing. 


:G 
REM looping... 
GOTO G 


produces an infinite sequence of messages: 


REM looping .... 
GOTO G 


If :/abel is not in the batch file, MS-DOS returns the error 


Label not found 
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HFORMAT External 
HFORMAT | drive][/S][/V][/P] 


«™ Parameters: 


(HARD DISK ONLY) Prepares a hard disk for use and, 
optionally, makes it an operating system disk by writing 
the system files to it. 


The hard disk may be either blank or already formatted 
when you enter the HFORMAT command. If the disk is 
already formatted, all information on it is erased when you 
reformat. 


Immediately after you enter the HFORMAT command, 
HFORMAT displays a screen similar to the following: 


Press any key to begin formatting drive 
Press (SPACEBAR). HFORMAT displays 


Formatting cylinders 


When the format is done without error, each dash, which 
represents an area on the disk, becomes a period. A ques- 
tion mark in place of a period indicates that a portion of 
the diskette contains flawed areas. HKORMAT locks out the 
flawed areas so that MS-DOS never writes to them. 


When the format is complete, MS-DOS displays this 
message: 


nnnnnnnn bytes total disk space 
nnnnnnnn bytes in bad sectors 
nnnnnnnn bytes available on disk 


drive is a drive specification of C: or greater. If you omit 
the drive, HFORMAT uses Drive C. 
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Sample Use: 


Example: 


/S causes HFORMAT to copy the system files (IO.SYS, 
MSDOS.SYS, and COMMAND.COM) to the disk after it is 
formatted. This makes the newly formatted disk a system 
disk. 

/V causes HFORMAT to prompt for a volume label after the 
disk is formatted. If you use this parameter, you may enter 
a label of up to 11 characters, or you may press to 
bypass the prompt. 

/P causes HFORMAT to prompt for the “interleave” factor 
and the number of cylinders and heads. If you are not an 
advanced user, you probably are not familiar with inter- 
leave factors, cylinders and heads. If not, we recommend 
that you do not use the /P parameter. 


Before vou can store information on a hard disk, you must 
prepare it using HFORMAT. During formatting, you have 
the option of transferring the system files to the hard disk, 
making it a system disk. The system files cannot be trans- 
ferred using the COPY command. Therefore, you'll prob- 
ably want to use HFORMAT /S to format your hard disk, 
and then type COPY A:*.*C: to copy all other files 


from vour system diskette to your hard disk. 


Note: Your MS-DOS System Diskette contains a special 
batch file, CONFIGHD.BAT, which automatically formats 
the hard disk and copies to it all files — system and 
non-system — that are on the diskette. If you want the 
option of not copying the non-system files, use the 
HFORMAT command. If you don’t care if all files are 
copied, simply type: 


CONFIGHD 


HFORMAT /S 


formats Drive C and transfers the system files to it. After 
removing the Drive A diskette and resetting your com- 
puter, you can start up your system under hard disk con- 
trol. From now on, the system prompt is C> (as long as a 
diskette is not in Drive A whenever vou start up or reset 
your system). 
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IF Internal 
IF [NOT] condition command 


Allows conditional execution of commands in batch file 


om processing. When the condition is true, then the com- 
mand is executed. When it is false, the command is 
ignored. 
Parameters: 


NOT changes the IF command so that the command 
executes only when the condition is false. 


The conditions are: 


ERRORLEVEL number, which indicates that the com- 
mand is to execute only if the program previously ex- 
ecuted by COMMAND has an exit code of number or 
higher. 


string1= = string2, which indicates that the command is 
to execute only if string and string2 are identical after 
parameter substitution. Strings may not have embedded 


oo separators. 


EXIST filename, which indicates that the command is to 
execute only if the file specified by filename exists. 


Sample Use: 


Use IF with the GOTO command to direct execution to 
particular subroutines when particular conditions exist. 
(See the GOTO command also.) 


Suppose you have three programs (Myprog, Samprog, and 
Salprog). Each requires that you be ina separate directory. 
You can create a batch file to put you in the proper 
directory. To do so, type 


COPY con progdir.bat 
REM This file changes the dir for Myprog, Samprog, 
or Salprog 

REM When executing, substitute the drive for %1, 
i | the program name for %2 

% 

IF %2= =Myprog GOTO W 

IF %2= =Samprog GOTO X 

IF %2==Salprog GOTO Y 
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Examples: 


‘W 

CHDIR \USER\MYPROG 
GOTO :Z 

:X 

CHDIR \USER\SAMPROG 
GOTO :Z 


‘Y 
CHDIR \USER\SALPROG 
z 


CHDIR 
‘END (ENTER 


Execute the batch file by entering its filename, followed by 
the drive and program name. For example, to change to 
the correct directory for Myprog, type 


progdir B: Myprog 


The batch file substitutes B: for %1, making Drive B your 
current drive. Then it substitutes Myprog for %2. It goes to 
label :W and changes the directory to \USER\MYPROG., 
Then it goes to :Z. The line following :Z causes CHDIR to 
display the current directory to verify that it is correct. 


IF NOT EXIST Myfile ECHO Can't find file (ENTER 
displays “Can't find file” if the file Myfile doesn’t exist. 
IF EXIST All.lst GOTO G 


sends program execution to the line following :G, if All. Ist 
exists. 
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MKDIR (Make Directory) Internal 


MKDIR pathname 
MD pathname 


Parameter: 


Makes a new directory. 


The MKDIR command is used to create a hierarchical 
directory structure. 


pathname tells MS-DOS under which directory to create 
the new directory and specifies the name to give it. The 
pathname may be either relative or absolute. 


Sample Uses: 


Examples: 


Using MKDIR, you can better organize your files. For 
example, you can group files according to user or use. 


You can also use MKDIR to create a directory in which to 
put your external commands. To do so, type 


MKDIR \BIN (ENTER 
MS-DOS creates the directory \BIN in the current drive. 


Use COPY to copy your command files into this directory, 
then use PATH to tell MS-DOS where to search for the 
commands. 


If you write an application program, you may want to 
include a MKDIR command so the program creates a 
directory the first time you run it. By following MKDIR 
with a CHDIR (change directory) command, you automati- 
cally enter the proper directory whenever you run the 
program. 


MKDIR \USER (ENTER 
creates the subdirectory \USER in your root directory. 
MD \USER\JOE (ENTER 


creates the subdirectory \USER\JOE in your \USER 
directory. 
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MD LETTERS 


creates the subdirectory LETTERS under the current direc- 
tory. If the current directory is \USER\JOE, MS-DOS cre- 
ates the directory USER\JOE\LETTERS. 


MD B:LETTERS (ENTER 


creates the subdirectory LETTERS under the home direc- 
tory of Drive B. If the home directory is \USER\JAN, 
MS-DOS creates the directory \USER\JAN\LETTERS. 
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MORE 
MORE 


Sample Use: 


Example: 


External 


Reads from standard input (such as a command from your 
keyboard) and displays one screen of information at a 
time. It then pauses and displays the message —MORE— 
at the bottom of your screen. 


Press (ENTER) to display another screen of information. 
This process continues until all the input data has been 
read. 


MORE is a filter. 


Use MORE to view long files. Suppose the file Myfiles.com, 
is on the current directory. You want to display it one 
screen at a time. To do so, type 


TYPE myfiles.com | MORE 


TYPE B:acctspay.dat | MORE 


displays the file Acctspay.dat that is on the home directory 
of Drive B, one screen at a time. MS-DOS displays the 
message —\MORE— at the bottom of each screen. Press 


ENTER) to continue. 
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PATH Internal 
PATH [pathname[|;pathname]... | 


Sets a command path, which tells MS-DOS the directories 
or drives in which to search for external commands. MS- 
DOS always searches the current directory before it 
searches the paths set by PATH. You can also use PATH to 
remind you of the current path. 


Unless you reset the path or turn off the system, MS-DOS 
searches the specified path(s) each time you use an exter- 
nal command. 


Parameters: 
pathname can specify either a directory or an entire drive. 


If you don’t include a pathname, PATH displays the cur- 
rent path setting. This serves to remind you which path 
MS-DOS is searching. If no path is set (MS-DOS is 
searching only the current directory), PATH displays the 
message No path. 


If you specify PATH ; (PATH followed by a semi-colon), 
MS-DOS sets the NUL path. It searches the current direc- 
tory only. 


Sample Use: 


PATH gives you the option of using commands that are not 
in the current directory. Suppose the root directory in 
Drive A contains so many files it is difficult to use efficient- 
ly. To save space, you create the directory A:\BIN (using 
MKDIR) and put your commands there (using COPY). 
Then you remove your commands from A:\ (using DEL). 


Suppose now that you start up MS-DOS and immediately 
want to format a disk in Drive B. Because FORMAT is an 
external command, you must do either of the following: 


* Use CHDIR to make A:\BIN your current directory 


¢ Use PATH to make MS-DOS search A:\BIN for external 
commands 
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Examples: 


To avoid encountering the problem repeatedly, use PATH. 
You can specify A:\BIN only, or you can specify all 
directories on Drive A, separating them with semicolons. 
To specify A:\BIN only, type: 


PATH A:\BIN (ENTER 
Type PATH (ENTER) to verify the path setting. 


PATH \BIN\USER\JOE (ENTER 
tells MS-DOS to search \BIN\USER\JOE in the current 
drive for external commands (after it searches the current 
directory). 
PATH \BIN\USER\JOE;\BIN\ USER\ SUE; 

\BIN\ DEV (ENTER 


tells MS-DOS to search the directories specified by the 
above pathnames for external commands. MS-DOS sear- 
ches the current directory and then those in the com- 
mand, in the order in which they are listed. 


PATH ; (ENTER 
tells MS-DOS to search the current directory only. 
PATH (ENTER 


displays the current path setting. 
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PAUSE 


Internal 


PAUSE [comment| 


Parameters: 


Suspends execution of the batch file and displays the 
message 


Strike a key when ready... 


At this time, you may press (SPACEBAR) to continue execu- 
tion, or you may press CTRL) CC) to display 
Abort batch job (Y/N)? 


If you press CY_), execution aborts and control returns to 
MS-DOS. If you press CN), execution continues. 


comment is a message to be displaved when the file 
pauses. The file displavs it before the message “Strike a 
key when ready...” 


Sample Uses: 


During the execution of the batch file, you may need to 
perform some action before executing the next com- 
mand. For example, you may need to change disks or 
make sure vour printer is ready. 


Whenever this is the case, include a PAUSE command 
where necessary, For example, suppose you want to list 
two files that are on different disks. Create a batch file by 
typing 


COPY con Typfiles.bat 

REM This file types the files Rental.dat and Sales.dat 
REM It is called Typfiles.bat 

TYPE B:\rental.dat 

PAUSE 

TYPE B:\sales.dat 

Typfiles.bat displays the file Rental.dat, then pauses and 
displays the message 


Strike a key when ready... 


Change disks; then press (SPACEBAR) to display the file 
Sales. dat. 
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You should also use PAUSE whenever you want the option 
to abort execution of the batch file. 


Suppose you create a batch file that combines all current 
directory files that have the extension Ist into the file 
all.Ist. If the file All. Ist already exists, you may not want to 
execute the copy. If you do so, the batch file destroys the 
original contents of AIL Ist. 

To avoid destroying All.Ist, create the batch file by typing 


Copy con Comblist.bat 

REM This file combines *.Ist files into All.|st 

IF EXIST All.lst PAUSE All.Ist already exists. Press 
C€_) to abort, or 

PAUSE 

COPY *.lst all.|st 


Suppose All.Ist exists and you don’t know it. When you 
execute the file, MS-DOS pauses and displays the message 


All.ist already exists. Press (CTRL) CC_) to abort or 
Strike a key when ready... 


If All. Ist does not exist, MS-DOS pauses and displays only 


Strike a key when ready... 


PAUSE Press (CTRL) CC_) if unsure or (ENTER 
pauses execution and displays the message 


Press (CTRL) CC _) if unsure or Strike a key when 
ready... 


PAUSE Insert disk to check in Drive B — 
pauses execution and displays the message 


Insert disk to check in Drive B — Strike a key when 
ready... 


PRINT 


External 


PRINT [pathname|/T][/C]|/P]] . .. 


Parameters: 


Sample Use: 


Lets you put up to 10 files in the print queue, so that 
MS-DOS prints them automatically while you process 
other MS-DOS commands. This is called “background 
printing.” 


The printer must be connected and ready. 


/T deletes (terminates) from the print queue all files that 
are there, waiting to be printed. 


/C deletes (cancels) from the print queue the file that 
immediately precedes and all files that follow /C in the 
command line. 


/P adds to the print queue (prints) the file that immediate- 
ly precedes and all files that follow /P in the command line. 


Regardless of the number of /C and /P parameters your 
command includes, each switch always affects the file 
immediately preceding it. For example, if you type this: 


PRINT budget /P sales rentals /C 


MS-DOS adds the files Budget and Sales, but cancels the 
file Rentals. 


If you omit all parameters, PRINT displays the contents of 
the print queue. 


Whenever you must print for a long time and must use 
your computer at the same time, use PRINT. The /C and /P 
parameters let you revise the print queue whenever doing 
so is most convenient. For example, you may queue these 
10 files: 


Jan 
Feb 
March 
April 
May 
June 
July 
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Aug 
Sept 
Oct 


by typing 


PRINT jan feb march april may june july aug sept oct 


By the time you finish working on something else, the Jan 
and Feb files are printed. Because these are no longer in 
the queue, there is room now to add the Nov and Dec files. 
In the meantime, you have changed your mind about 
printing Aug. To update the print queue accordingly, type 


PRINT nov /P dec aug /C 


The file March is being printed, and the queue contains 
these files: 

April 

May 

June 

July 

Sept 

Oct 

Nov 

Dec 


PRINT /T 
empties the print queue. 
PRINT A:temp1.tst /C A:temp2.tst A:temp3.tst (ENTER 


removes the files A:Temp1.tst, A:Temp2.tst, and 
A:Temp3.tst from the print queue. 


PRINT temp1.tst /C temp2.tst /P temp3.tst 


removes the file Temp1.tst from the queue and adds the 
files Temp2.tst and Temp3.tst. 
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Errors: 


If it finds an error, PRINT displays one of the following 
error messages: 


Name of list device [PRN:] 


MS-DOS displays this prompt the first time you run 
PRINT. You may enter any current device as the PRINT 
output device. If you press only, the printer 
becomes the device. 


List output is not assigned to a device 


The device specified as the PRINT output device is in- 
valid. 


PRINT queue is full 

The queue can contain no more than 10 files. 
PRINT queue is empty 

There are no files in the print queue. 

No files match pathname 


The files you tried to add to the queue do not exist. 
(Note that MS-DOS displays no message if you try to 
cancel files that are not in the queue.) 


Drive not ready 

If this message occurs when PRINT attempts a disk ac- 
cess, PRINT keeps trying until the drive is ready. Any 
other error causes PRINT to cancel the current file. In 


such a case, PRINT outputs an error message to the 
printer. 


PRINT may output either of the following messages to the 
printer. They serve only to remind you that the printout is 
incomplete. 


All files canceled by operator 


You used the /T parameter to cancel the printing of all 
files in the print queue. 


124 


Section II / Commands Reference 
File canceled by operator 


You used the /C parameter to cancel the current file in 
the print queue. 
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PROMPT Internal 
PROMPT [ prompt-text] 


Changes the MS-DOS system prompt to prompl-tent, 
Parameters: 


prompt-text is a string of characters to set as the prompt. 
It can be any of the following: 


* A string of characters, such as your name 

* A special prompt in the format $cbaracter where char- 
acter is one of those in the chart below. 

* A combination of special prompts or of a string and 
special prompt(s) 


Character Prompt 
$ The $ character 
t The current time 
d The current dlate 
p The current directory 
V The MS-DOS version number 
n The current drive specification 
g The > symbol 
| The < symbol 
b The | symbol 
= A carriage return and line feed 
s A leading space 
h A backspace 


The escape sequence 


ay 


If you omit prompt-text, MS-DOS sets the current drive 
specification as the prompt. 

Sample Uses: 
There are several reasons for using a special system 
prompt. 
For example, by setting the current directory as the 
prompt, you need not enter the CHDIR command to 
remind you which directory you're in. To set the directory 
as the prompt, type 


PROMPT $p 
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By setting the time as the prompt, you can check the time 
without entering the TIME command. In this way, you can 
also time the execution of commands and programs. To 
set the time as the prompt, type 


PROMPT $t 


Notice how you can use $_ to insert a carriage return and 
line feed in your prompt: 


PROMPT Time = $t$.Date = $d 


In this case, the new system prompt is similar to the 
following: 


Time = 0:07:04.07 
Date = Thu 11-15-1984 


Because your computer has an ANSI escape sequence 
driver (ANSI.SYS) you can use escape sequences in your 
prompts, if the ANSI device driver is configured into your 
system. (See Appendix C.) For example, 


PROMPT $e[7m$n:$e[m 


sets the prompts in reverse video mode and returns to 
video mode for other text. 


PROMPT $n$qg 


sets the current drive, followed by a greater-than sign (>) 
as the prompt. For example, when you change to Drive B, 
the prompt changes to B>. When vou receive vour system, 
PROMPT is set to $n$g. 


PROMPT A$qg (ENTER 

sets the prompt A>. Regardless of which drive youre in, 
this is the prompt. 

PROMPT $p 


sets the current directory, including the current drive, as 
the prompt. 


Note: As you can see from the A$g example, some 
prompts hinder, rather than help. Use PROMPT carefully. 
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RECOVER 


External 


RECOVER pathname 
RECOVER drive 


Parameters: 


Sample Use: 


Examples: 


Recovers (1) a file that contains bad sectors, or (2) all files 
on a disk that contains bad sectors in its directory. 


In the first case, MS-DOS reads the file sector-by-sector. It 
marks the bad sectors in a system table, so the data is never 
again allocated to them. 


In the second case, MS-DOS scans the disk file allocation 
table (FAT) for chains of allocation units. It creates a new 
root directory for each chain. Use the RECOVER drive 
command only if the disk’s directory is unusable. 


If there is not enough room in the root directory, RECOV- 
ER displays a message to this effect. It then stores informa- 
tion about the extra files in the File Allocation Table. When 
there is enough room, you can use RECOVER again to 
regain the files. 


pathname specifies the file to recover. You must include 
the filename part of the pathname. 


drive specifies the disk to recover. 


If you have trouble storing and maniplulating information, 
the disk may have a flawed sector. Running CHKDSK 
(check disk) should indicate whether this is the case. If the 
file that contains the flawed sector is a text file, recover the 
file. This saves all information except that in the flawed 
sector. Re-enter the lost information. If the file is a data file, 
recovering the file may or may not help. 


Note: If you are a beginner, you may prefer re-entering all 
information to trying to recover a file. 


RECOVER \USER\SAM\pamphlet.txt 


recovers the file \USER\ SAM \ Pamphlet.txt that is on the 
current disk. 
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RECOVER oldbook.txt 


recovers the file Oldbook.txt that is in the current 
directory. 


RECOVER B: 


recovers the disk in Drive B, if the bad sectors are in the 
directory. 
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REM (Remark) Internal 
REM [remark| 


Lets you include the specified remark in a batch file. 
Parameter: 


A remark is a line the batch file displays (during execu- 
tion) but does not try to execute. It displays the remark 
only if ECHO is on. 


The space, tab, and comma are the only separators 
allowed in the remark. 


Sample Uses: 
Use REM as needed to do the following: 
* Remind vou of the file’s name and use 
* Keep track of what a particular command is doing 
* Include warnings in the file 


In this file, the first remark reminds you to replace pa- 
rameters %1, %2, and %3 when executing the file. The 
second remark simply reminds vou of the file’s name. 


COPY con 3dir.bat 

REM This file displays directory listings for %1, %2, 
and %3 

REM It is called 3dir.bat 

FOR %%f IN (%1 %2 %3) DO DIR %%f 


Examples: 
REM This file is called Billfile.bat 
displays the following message, if ECHO is on: 
REM This file is called Billfile.bat 


REM pathnamet1 replaces %1, pathname2 replaces 
%2 


displays the following message, if ECHO is on: 


REM pathname1 replaces %1, pathname2 replaces 
%2 
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REN (Rename) Internal 


REN pathname filename 


Parameters: 


Changes the name of the file specified by pathname to 
filename. 


If you include a wild card in the filename, MS-DOS leaves 
the corresponding characters as they were. For example, if 
you type the following: 


REN newfile old???? (ENTER 


MS-DOS changes the name of the file Newfile that is in the 
current directory to Oldfile. 


If you include a wildcard in the pathname, also, MS-DOS 
renames all files in the specified directory that match the 
pathname. For example, if you type the following: 


REN *.Ist *.prn 


MS-DOS changes only the extension of all .Ist files that are 
in the current directory. The new extension is .prn. The 
file Suefile.Ist, for example, becomes Suefile.prn. 


Sample Uses: 


There are several reasons to rename a file. Here are a few: 
* To indicate the owner of the file 
* To indicate that one file is newer than a similar file 


* To make it easier to do operations on several files of the 
same type 


* To correct an error you made in the name 


For example, suppose your current directory contains two 
similar files, Oldfile and Newfile, and you plan to create a 
third. If you don’t need Oldfile, delete it by typing 


DEL oldfile 
Then change the name of Newfile to Oldfile by typing 
REN newfile oldfile (ENTER 
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Examples: 


Use EDLIN to create the newest file, naming it Newfile (see 
Section III, “EDLIN’”’). Now you can easily tell, from the 
filenames, which data is new. 


Suppose you have several files that have the extension .|st 
and several that have the extension .prn. You often do the 
same operations on both sets of files (example: DIR *.Ist 
and DIR *.prn). To avoid this, rename one set by typing 


REN *.Ist *.prn (ENTER 
Now you need only this command to see the listing: 
DIR *.prn 


Note: Perhaps the most practical use of RENAME is to 
rename a file that contains a flawed sector. If a file is 
flawed, you can use RECOVER to save all information 
except that in the flawed sector. To prevent MS-DOS from 
writing any new files to that area, however, you should 
keep the flawed file there. Rename the file to Badspot to 
remind you of the flaw. 


REN B:\USER\GL1.dat GL2.dat 


changes the name of the GL1.dat file that is in B: \USER to 
GL2.dat. 


REN B:Mufile ?y???? 


changes the name of Mufile, a file in the home directory in 
Drive B, to Myfile. 
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If you try to give a file a name that already exists, MS-DOS 
displays the following error message: 
Duplicate file name or File not found 


For example, suppose your current directory contains the 
files Myfile.Ist and Myfile.prn, in that order. If you use this 
command: 


REN Myfile.* Suefile.prn 


MS-DOS changes the name of Myfile.Ist to Suefile.prn. 
Then because Suefile.prn now exists, it does not rename 
Myfile.prn. Instead, it displays the error message. 
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RESTORE 


External 


RESTORE drive [ pathname][/S]|/P | 


Parameters: 


Sample Use: 


Examples: 


(HARD DISK ONLY) Restores one or more files from 
diskettes to a hard disk. RESTORE copies only files that 
were stored on diskette using the BACKUP command. 


drive specifies the drive containing the backup files. 
pathname specifies the hard disk file you want to restore. 


/S causes RESTORE to restore all files in the specified 
directory and all directories below it. 


/P causes RESTORE to prompt you before restoring files 
that have been changed since the last backup and all 
“read-only” files. 


As long as you have a complete library of backup diskettes, 
restoring your hard disk should be straightforward. Sup- 
pose you want to restore all the files that were backed up 
from all directories on Drive C. Insert the first backup 
diskette into Drive A; then type 

RESTORE A: C:\/S 

Note: If you have several files to restore — but not all 
files, as in the previous example — you may want to create 
a batch file consisting of the necessary backup commands. 
Then you can do all the backups simply by running the 
batch file. 


RESTORE A: C:*.dat/P 


restores all files from Drive A that have the extension .dat 
and that were backed up from the current directory of 
Drive C. 


RESTORE A: C:\USER \store1.dat 


restores from Drive A the file Storel.dat that was backed 
up from the USER directory of Drive C. 
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RMDIR (Remove Directory) _ Internal 


RMDIR pathname 
RD pathname 


en Removes from the disk the sub-directory specified by 
pathname. 


Note: You cannot remove the root directory or the cur- 
rent directory. 


The directory must be empty except for the . and... 
symbols. 


Before you try to remove a directory, use the DIR com- 
mand to see what files are in the directory. If you may need 
a file, use the COPY command to move it to another 
directory. Then use the DEL command to delete all files 
you don’t need. 


Sample Use: 


Whenever you delete or copy all of a directory’s files, you 
may want to remove the directory. Doing so saves valuable 


fo disk space. 


Suppose a sales representative, Ann, retires, and you 
want to divide her accounts between Sue and Jim. 
If \USER\ANN\ACCTS is not your current directory, 
use a CHDIR command to make it so. Now copy each 
account file to either \USER\SUE\ACCTS or 
\USER\JIM\ACCTS, using a command similar to the 
following: 


COPY drugstor.dat B:\ USER\SUE 


Note: Changing directories to \USER\ ANN\ACCTS saves 
you from entering a complete pathname for the source file 
in each COPY command. 


You are almost ready to remove \USER\ANN\ACCTS. 
Because you can’t remove the current directory, however, 
you must first change directories. Type 


CHDIR.. 
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MS-DOS puts you in \USER\ANN. Remove the directory, 
using either an absolute pathname 


RMDIR \USER\ANN\ACCTS (ENTER . 
or a relative pathname 
RMDIR ACCTS 


Examples: 
RMDIR \BIN\USER\JIM 


removes the subdirectory \BIN\USER\JIM from the cur- 
rent disk. 


RMDIR MEMOS 


removes the subdirectory MEMOS from the current 
directory. 


RMDIR B:MEMOS 


removes the subdirectory MEMOS from the home direc- ~ 
tory in Drive B. 


— 
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SET Internal 
SET |parameter= [replacement parameter]] 


Sets the parameter equal to the replacement parameter 
fo™ for use in later programs and batch files (until you unset 
the parameter or turn off the computer). 


SET does not affect commands at the system level, other 
than those in batch files. 


Parameters: 


parameter can be any character string, except the num- 
bers 0 through 9. You may want to use general terms (such 
as drive, pathname, program name, filename, and text), or 
you may want to save space by using only a character or a 
few characters. You may include imbedded separators in 
the parameter. 


replacement parameter can also be any character 
string, except the numbers 0 through 9. Here, however, 
use specific parameters (such as B:, \USER, Myprog, 

r™ Myfile, and This is the real text). If you omit the replace- 
ment parameter, MS-DOS voids the current setting of the 
parameter. 


If you omit parameter = replacement parameter, SET 
returns the values that are set. 


Sample Use: 


The greatest advantage of the SET command is this: If you 
have several batch files that require the same replacement 
parameter, you don’t need to substitute it repeatedly. 


Suppose you have several batch files that contain the 
parameter % filename%. One might contain the command 


TYPE %filename% (ENTER 
Another might contain the command 
COPY A:%filename% B: (ENTER 


(Note: Within the batch file commands, the parameter is 
enclosed by per cent signs. Within the SET command, it is 
not.) 
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The first time you run all the batch files, you may want to 
substitute Myfile for %filename%. To do this, use the SET 
command before you begin. Type io 


SET filename = Myfile 


MS-DOS automatically substitutes each occurrence of 
%filename% — in all batch files — with Myfile. Now 
suppose you want to substitute Samfile for %filename%. 
Void the current setting by typing 


SET filename = (ENTER 
Then reset the parameter by typing 
SET filename = Samfile (ENTER 


The SET command lets you write versatile batch files. Here 

is an example. As you may already know, the PROMPT 
command lets you set your own system prompt. (The 
default prompt is the current drive followed by a greater- 

than sign, such as A>.) Suppose you have four system - 
prompts, all of which you use often. Rather than repeated- 

ly entering the PROMPT command with parameters, use 

batch files to do the work for you. 


First, assign each prompt a unique parameter that is to 
represent it in a batch file. 


* promptd = default prompt (current drive) 


* promptl = time and date 

* prompt2 = current directory 

* prompt3 = version number and a greater-than 
symbol 


Then set each parameter equal to its replacement pa- 
rameter (the code required by the PROMPT command), 
by typing 


SET promptd=$n$g 


SET prompti =The time is $t$_The date is oo 
$d 


SET prompt2=$p 
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SET prompt3 = $v$g 


Now create four batch files, each containing a PROMPT 
command, as follows: 


COPY con promptd.bat 

REM This file changes the system prompt to the 
default (current directory) (ENTER 

PROMPT %promptd% 


COPY con promptt.bat 

REM This file changes the system prompt to the 
current time and date 

PROMPT %prompt1% 


COPY con prompt2.bat 

REM This file changes the system prompt to the 
current directory 

PROMPT %prompt2% 


COPY con prompt3.bat 

REM This file changes the system prompt to the 
version number and greater-than symbol 

PROMPT %prompt3% 


Now you can quickly change your prompt to any of the 
four, simply by executing the appropriate batch file. For 
example, execute promptl.bat by typing 


prompt1 (ENTER 


The file replaces the parameter prompt? with $n$g and 
changes the system prompt accordingly. 


If you want to use prompts other than those set, you can 
either set them or change an existing setting. Remember, 
the settings continue to affect these files and other batch 
files until you unset them or reset or turn off the 
computer, 
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Examples: 


Note to Advanced Users: You can use SET to affect 
application programs, as well as batch files. The MS-DOS 
Programmer's Reference Manual, Catalog #26-5403, tells 
you what you need to know about “Program Segment 
Prefixes” to be able to do this. The manual is available at 
your Radio Shack Computer Center. 


SET drive=B: 

sets B: to replace the parameter drive in later programs. 
SET drive= (ENTER) 

voids the current setting for the parameter drive. 

SET 


displays the current settings for COMPSPEC, PATH, 
PROMPT, and SET. 
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Internal 


Lets you use more than the usual 10 replaceable pa- 
rameters (0%-9% ) in batch file processing. 


Here is how SHIFT works. Suppose your batch file, 
Money.bat, contains replaceable parameters, defined as 
on the left. When you enter the SHIFT command, each 
definition shifts one place. Instead of replacing %7, it 
replaces %-1. 


Definitions Before Definitions After 
Shift One Shift 
%0 = Money %0 = Pharm.dat 
%1 = Pharm.dat %1 = Autodeal.dat 
%2 = Autodeal.dat %2 = Hardware.dat 
%3 = Hardware.dat %3 = Grocery.dat 
%4 = Grocery.dat %4 = Dimestor.dat 
%5 = Dimestor.dat %5 = Theater.dat 
%6 = Theater.dat %6 = Cafe.dat 
%/ = Cafe.dat %7 = Photo.dat 
%8 = Photo.dat %8 = Beauty.dat 
%9 = Beauty.dat %9 = undefined 


As you can see, %9 is now open to be redefined. Money, on 
the other hand, no longer replaces any parameter. If you 
must refer to Money again, there are two ways to do it: 


° Use SHIFT so that Money replaces %9, or 
¢ Use SET to set Money equal to a text parameter 


You may execute as many shifts as needed. If you do, 
however, include ECHO %v in your file as needed to keep 
track of each replaceable parameter’s current definition. 
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Sample Use: 


Example: 


As you know, you can use SHIFT to gain access to more @™, 
than 10 replaceable parameters. Even if you don’t need 

that many parameters, however, you can use SHIFT to save 

you typing time. 


The batch file below lets you copy as many files as you 
wish from A:\USER to B:\USER. It substitutes the first 
given file for %1 and copies it. Then it substitutes the next 
file, copies it, and so on. Create the batch file as follows: 


COPY con shiftcop.bat 
REM Stop execution at pause after all files are 
copied 
:PAUSE 
PAUSE 
COPY A:\USER\%1 B:\USER\%1 
SHIFT 
GOTO PAUSE 
o 


Suppose you want to copy the files Find.exe, Namel.asm, 
and Name2.asm from A:\ USER to B:\USER. Simply enter 
the name of the batch file, followed by the files to copy, as 
shown here: 


shiftcop find.exe name1.asm name2.asm (ENTER 


The batch file pauses before each copy, giving you the 
option to abort. After it copies all files, press CTRL) CC) at 
the PAUSE prompt (Strike a key when ready...). 


SHIFT (ENTER 

shifts all parameters that replace the parameters %0 
through %9 down one. Suppose that, before the shift, % 1 
equals Denfile.dat and %2 equals Myfile.dat. After the @v™, 
shift, %0 equals Denfile.dat and %1 equals Myfile.dat. 
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SORT 


External 


SORT [/R] [/+ 0] [<input pathname] 
[>output pathname] 


es 


Parameters: 


fe" Sample Use: 


Reads input from the keyboard or a file, sorts the data, and 
writes it to the display or a file. 


SORT is a filter. 


<input pathname specifies file to be sorted. If you omit 
this parameter, SORT sorts keyboard input. 


>output pathname specifies the file to receive the 
sorted information. If you omit this parameter, SORT 
sends the output to the display. 


/R reverses the sort (sorts from Z to A). If vou omit this 
parameter, the sort is from A to Z. 


/+.n begins the sort at Column 7. If you omit this param- 
eter, the sort begins at Column 1. 


You might use SORT to alphabetize a file by a certain 
column. Suppose you have this information in a file, 
Mail.dat, on the current drive: 


Jan King 2 8th St. Lincoln NE 68502 
Sam Beck 4 6th St. Rapid City SD 57001 
Sal Cleo 7 9th St. Ft. Worth TX 76133 


You may want to sort the file alphabetically, according to 
last name, and then store the sorted output in another file. 
To do so, type 


SORT /+15 <mail.dat >sortmail.dat (ENTER 


SORT sorts the contents of Mail.dat, starting at Column 15 
(last name). It then outputs the sorted data into the file 
Sortmail.dat. 
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Examples: 


SORT /R <unsort.txt >sort.txt (ENTER 


reads the file Unsort.txt, reverses the sort, and then writes 
the output to a file named Sort.txt. 


DIR | SORT /+ 14 CENTER) 


pipes the output of the DIR command to the SORT filter, 
which sorts the directory listing, starting at Column 14 (file 
size). SORT then displays the output. Thus, the result of 
this command is a directory sorted by file size. 


DIR | SORT /+ 14 | MORE 


does the same thing as the command in the previous 
example, except that the MORE filter displays the direc- 
torv one screen at a time. 
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SYS (System) External 


SYS drive 


Sample Use: 


Error: 


Transfers the files IO.SYS and MSDOS.SYS (the MS-DOS 
system files), in that order, from the current disk to the 
disk in the specified drive. 


The target disk may be blank, in which case transferring 
the files converts it to a system disk. Or, it may contain old 
system files, in which case transferring the files updates 
the system. 


1O.SYS and MSDOS.SYS are both hidden files that do not 
appear when the DIR command is executed. COM- 
MAND.COM (the command processor) is not transferred. 
You must use the COPY command to transfer 
COMMAND.COM. 


Data disks and many application program disks do not 
contain the system. As is, such a disk can be used only if 
you have a system disk in Drive A. With the system files on 
it, however, it can be used alone. 


SYS B: 


transfers the system files from the current disk to the disk 
in Drive B. 


If SYS detects an error, MS-DOS displays one of the follow- 
ing messages: 


No room for system on destination disk 


If the target disk contains files you don’t need, use the 
DEL command to delete as many as necessary to make 
room for the system. Otherwise, use a different disk as 
the target. 


Incompatible system size 


The system files IO.SYS and MSDOS.SYS do not take up 
the same amount of space on the target disk as the new 
system requires. 
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TIME 


Internal 


TIME [hh:mm:ss.cc]| 


Parameters: 


Displays or sets the time. 


You can change the time from the keyboard or from a 
batch file. (Normally, MS-DOS displays a time prompt 
each time you start up your system. It does not, however, if 
you use an Autoexec.bat file. Therefore, you may want to 
include a TIME command in that file.) 


[hh:mm:ss.cc] specifies the time to set. 


bh == 0-24 (hours) 

mm = 0-59 (minutes) 

SS = 0-59 (seconds) 

cc = 0-99 (hundredths of a second) 


If you include only part of the information (such as the 
hours) and press (ENTER), the other fields default to zero. 


If you omit the time, TIME displays the current time and 
prompts you to enter the new time. Enter it in the 24-hour 
format, or press the key if you don’t want to change 
the time displayed. 


Sample Uses: 


When you change the time known to the system, you also 
change the time in any application program you use. This 
can be very handy. 


Suppose that you have a program that keeps track of 
customer calls according to the date and time received. 
For some reason, you get behind and can’t enter the 
information at the correct time. Simply enter it later, after 
“turning back the clock” to the necessary time. 


You can also use DATE and TIME to include the date and 
time on a printout. (See the DATE command.) 


In addition, TIME lets you keep track of the time and can 
give you an idea how long it takes to run a particular 
program. 
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TIME 14 (ENTER 
sets the time to 2:00 p.m. 
TIME 2:32 (ENTER 


sets the time to 2:32 a.m. 


If the options or separators are not valid, MS-DOS displays 
the message 


Invalid time 
Enter new time: 


It then waits for you to enter a valid time. 


TYPE 


Internal 


TYPE pathname 


Sample Use: 


Displays the contents of the specified file. 


TYPE makes only one change to the file’s format. It ex- 
pands tabs to spaces consistent with a tab stop at every 
eighth column. 


Note: A display of binary files causes control charac- 
ters (such as end-of-file characters, bells, form feeds, 
and escape sequences ) to be sent to vour computer. 


Use TYPE to see if you need to change a file. If so, use 
EDLIN. 


Suppose you create a batch file, as follows: 


COPY con prepdisk.bat 

REM This is a file to prepare and check new disks 
REM It is called Prepdisk.bat 

FORMAT B: 

PAUSE 

CHKDSK B: 


Because you don't specify otherwise, MS-DOS creates the 
file in your current directory. Therefore, to display the file, 
type only 

TYPE prepdisk.bat (ENTER 

MS-DOS displays 

REM This is a file to prepare and check new disks 
REM It is called Prepdisk.bat 

FORMAT B: 


PAUSE 
CHKDSK B: 
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Examples: 


TYPE \USER \ taxfile.dat 


displays the file Taxfile.dat that is in the \USER directory 
in the current drive. 


TYPE B: carfile 


displays the file Carfile that is in the home directory of 
Drive B. 


TYPE B:\BUDGET \clothes 
displays the file Clothes that is in B:\ BUDGET. 


VER (Version) Internal 
VER 


Displays the number of the MS-DOS version that you are 
using. 


Sample Use: 


If you have a question or comment regarding your system, 
you'll need to know the MS-DOS version number when 
you contact the Tandy customer services department. 


Example: 
VER 


displays the version number. 
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VERIFY Internal 
VERIFY [ONIOFF] 
Turns the verify switch on or off, or displays the current 
setting of VERIFY. 


VERIFY has the same purpose as the /V switch in the COPY 
command. When it is on, it tells MS-DOS to verify that your 
files are intact (they contain no bad sectors, for example). 


Parameters: 


VERIFY ON remains in effect until you change it in a 
program (by using a SET VERIFY system call), or until you 
use VERIFY OFF. When VERIFY is on, it verifies all writes to 
disk. 


If you omit ON and OFF, MS-DOS returns the current 
setting of VERIFY. 


Sample Use: 


By keeping VERIFY on, you always know if your files are 
intact. Note, however, that this slows down operation. 


Examples: 
VERIFY ON 
tells MS-DOS to verify all writes to disk. 
VERIFY OFF 
tells MS-DOS to stop verifying writes to disk. 
Error: 


You receive an error message only if MS-DOS was unable 
to successfully write your data to disk. 
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VOL (Volume) Internal 


VOL [ drive] 


Parameters: 


Sample Use: 


Example: 


Displays the volume label of the disk in the specified drive. 
(Remember, you can assign a label by using the /V pa- 
rameter in the FORMAT command. ) 


If the disk does not have a volume label, VOL displays 


Volume in drive n has no label 


If you omit the drive, MS-DOS displays the volume label of 
the current disk. 


Enter the volume command whenever you forget a 
volume label. For the disk in Drive B, type 


VOL B: (ENTER 
MS-DOS displays a message similar to this: 


Volume in drive B is DISKONE 


VOL 


displays the volume label of the current disk. 
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Section III 
The Line Editor (EDLIN) 


EDLIN is a text line editor program. It consists of several 
commands that let you create, change, and display source 
program or text files. This section describes the various 
EDLIN commands and provides some practical examples 
of their use. 


It also explains how to use the editing keys to edit files. 
(You were introduced to these keys in Section I Chapter 4, 
which explained how to use them to edit MS-DOS 
commands. ) 


Some common uses for EDLIN include: 
* Creating and saving new source files. 


* Updating existing files and saving the updated and 
original versions. 


* Deleting, editing, inserting, or displaying lines. 


* Searching to replace or delete text within one or more 
files. 


Files you create with EDLIN are divided into lines of up to 
253 characters. During editing, EDLIN generates and dis- 
plays a number for each line. If vou insert or delete one or 
more lines, it automatically renumbers the following lines 
as needed to maintain consecutive numbering. The line 
numbers are only to aid you in editing; they are not 
actually in the file. 


Starting the EDLIN Program 


To start EDLIN, simply type 
EDLIN pathname (ENTER 


where pathname refers to either an existing file (that you 
wish to edit) or one that you wish to create. 
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Editing an Existing File 


If the file specified by pathname currently exists in the A7™, 
designated drive, EDLIN loads it into memory. It then 
displays the message 


End of input file 


You may then edit the file using EDLIN commands and 
editing keys. (Notice that the prompt for EDLIN is an 
asterisk (“) and that the underscore (~) represents the 
cursor ). 


If the file is large, EDLIN loads lines until] memory is 75% 
full. When it displays the * prompt, you can edit those 
lines. To edit more of the file, you must first free some 
memory by writing the edited lines to disk (see the Write 
command in this section). Then you can load more of the 
file for editing (see the Append Lines command). 


- 
Creating a File and Editing It - 
If the file specified by pathname does not exist in the 
designated drive, EDLIN creates the file in memory. It 
gives the file the specified name and prompts vou with 
New file 
To enter text into the newly created file, type 
| (ENTER 
The I command (insert lines) is discussed in further detail 
later. EDLIN displays the number of the first line, followed 
by the asterisk: 
1 
- 


154 


Section IIT / EDLIN 


At this point, you can begin entering information. 
Remember, you may include up to 254 characters in each 
line. If you try to enter more, EDLIN generates a beep. To 
end one line and start another, press (ENTER). EDLIN places 
the line you just typed in the template and displays the 
next line number. 


Saving Files 


After editing an existing file, you can save the original and 
the edited versions by using the End command. Regard- 
less of the extension you specified in the pathname, EDLIN 
saves the original file with the extension .bak. It saves the 
edited file with the extension you specified. 


When you save a newly created file, EDLIN gives it the 
filename and extension vou specified. 


Note: You cannot further edit a file that has a .bak exten- 
sion because EDLIN assumes it is a backup file. To over- 
come this system restriction, you can rename the file, 
giving it another extension. (See the RENAME command 
in Section II.) 
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Special Editing Keys 


In Chapter 4, you learned how to use the special editing 
keys to correct and change MS-DOS commands. You can 
also use them to edit lines within your files. 


EDLIN sends newly typed lines to the template. This makes 
it possible to repeat or change file lines with the editing 
keys. 


The table below summarizes the editing keys’ functions as 
they apply to file editing. 


Function Key Description 

Copy char Copies one character to the new 
line. 

Copy to char (F2) char Copies all characters up to the 

: specified character to the new 

line. 

Copy all (F3) Copies all remaining characters in 
the template to the new line. 

Delete char Deletes a character in the tem- 


plate. Therefore, the character js 
skipped (is not copied to the new 
line). 


Delete to char (F4) char Deletes all characters up to the 
character specified. Therefore, 
those characters are skipped (are 
not copied to the new line). 


Void line or ee Voids the current input; leaves the 
template unchanged. 

Insert Enters/exits the insert mode. 

Replace template (F5) Replaces the template with the 


characters displayed to allow 
further editing. (The characters 
are not sent to the program.) 


Enter line Makes the new line the new tem- 
plate and sends it to the request- 
ing program. 

Tab forward Moves cursor forward to the next 


tab stop. 
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Sample Uses for the Editing Keys 


In this section, you will create a sample file and practice 
editing with the editing keys. 


Creating a File 


To create the sample file, simply insert your MS-DOS 
system disk in Drive A and type 

EDLIN sampfile (ENTER 

If you want the file to reside in a directory other than the 
current directory, specify the directory. This command, 


for example, tells EDLIN to create the file in the home 
directory of Drive B: 


EDLIN B:sampfile (ENTER 
EDLIN displays the message and prompt 


a, New file 


* 


to indicate it has created the sample file. 


Entering Information in the Sample File 
1. Type | (ENTER) to begin inserting text. The screen dis- 
plays: 
New file 
yl 
Whe 
2. On Line 1, type 
This is a sample file (ENTER 
EDLIN displays the number for the next line. 
. Type 
The editing keys are easy to use (ENTER 


4. When EDLIN displays the next line number, press 
CTRL) CC _). This exits the insert mode and returns the 
EDLIN prompt (*). 


c7 
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5. Press C1_) (ENTER) to tell EDLIN to display Line 1. The 
screen looks like this: 
*4 
1:*This is a sample file 
Wes 


Having created the sample file, you are ready to begin 
using the editing keys. 


Example 1: Copy Char (~)) 


Using the Copy Char function, @), copy characters from 
the template to the new line. 


1. Press once. The screen looks like this: 


1:*This is a sample file 
Te es 


i) 


Press three times. The screen looks like this: 
1:*This is a sample file 
12" THs 


Each time you press (*), EDLIN copies another charac- 
ter from the template to the new line. 


3. To continue to the next example, press CTRL) CC). 
This exits the insert mode, voids any changes you have 
made to the line, and returns the EDLIN prompt ("). 


Example 2: Copy to Char ((F2)) 


Using the Copy to Char function, (F2), copy all characters 
from the template, up to — but not including — the 
specified character. 


1. At the EDLIN prompt, press C2_) (ENTER). The screen 
looks like this: 


2:*The editing keys are easy to use 
er. 
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2. Press (F2) and type a. The screen looks like this: 


2:*The editing keys are easy to use 
2:*The editing keys - 


3. Now copy the rest of the template, using the Copy All 
function, (F3). The screen looks like this: 


2:*The editing keys are easy to use 
2:*The editing keys are easy to use 


4. Press CTRL) CC_) to continue to the next example. 
Note: If the template does not contain the specified 
character, nothing is copied. 
Example 3: Copy All ((3)) 


Using the Copy All function, (F3), copy the entire contents 
of the template to the new line. 


1. Press C1_) (ENTER) at the EDLIN prompt (“). The screen 
looks like this: 


1:*This is a sample file 
Lie 
2. Press the Copy All editing key, (F3). The screen looks 
like this: 
1:*This is a sample file 
1:*This is a sample file 
3. Press CTRL)CEC ) to continue to the next example. 


Note: The Copy All function copies all characters in the 
template to the new line. However, if you changed part 
of the template, the Copy All function copies only the 
remaining characters — those that have not been 
edited. 
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Example 4: Delete Char ((DELETE)) 


Using the Delete char function, delete some characters 
from the template. 


1. 


i) 


At the EDLIN prompt, press (2_) (ENTER). The screen 
looks like this: 


2:*The editing keys are easy to use 
ors 


. Press (QELETE) three times to delete the first three 


characters from the template. Then press the Copy All 
function key, (F3). The screen looks like this: 


2:*The editing keys are easy to use 
2:* editing keys are easy to use 


. Press TRL)CC_) to void any changes to Line 2 and 


continue to the next example. 


Example 5: Delete to Char ((F4)) 


Using the Delete to Char function, (F4), delete a number of 
characters up to — but not including — the specified 
character. 


1. At the EDLIN prompt, press (1_) (ENTER). The screen 


i) 


looks like this: 


1:*This is a sample file 
i 


. Press and type a. The cursor remains in the same 


position even though the characters before the first a 
have been deleted. To see this, press the Copy All key, 
(F3). The screen looks like this: 


1:*This is a sample file 
1:*a sample file. 


. Press CTRL)CC_) to void any changes and continue to 


the next example. 
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Example 6: Void Line ((F8) 


In this example, first make a change to Line 1 and then, 
using the Void Line function key, (F8), cancel that change. 
This leaves the template unchanged and lets you continue 
making changes to the same line. 


1. At the EDLIN prompt, press (1_) (ENTER). The screen 
looks like this: 


1:*This is a sample file 
ike 

2. Type 
Names and addresses 
The screen looks like this: 


1:*This is a sample file 
1:*Names and addresses \ 


When you press (F8), a backslash (\) appears right after 
any change you may have made and the cursor is 
displayed again on another line. 


3. Press the Copy All key, (F3). The screen looks like this: 


1:*This is a sample file 
1:*Names and addresses \ 
This is a sample file - 


4. Press CTRDCC_) to continue to the next example. 
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Example 7: Insert (CINSERT)) 


The (INSERT) key acts as a switch to turn the insert mode on 
and off. Use this key to insert a word in Line 1 of the sample 
file. 


1. At the EDLIN prompt, press (1_) (ENTER). The screen 
looks like this: 


1:*This is a sample file 
ye 


in) 


. Press the Copy to Char key, (F2) and type f. The screen 
looks like this: 


1:*This is a sample file 
1:*This is a sample - 


3. Now press to turn on the insert mode. Type 
edit, followed by a single space. Then press (INSERT 
again to turn off the insert mode. The screen looks like 
this: 
1:*This is a sample file 
1:This is a sample edit - 


4. To copy the rest of the characters in the template, press 
the Copy All key, (F3). The screen looks like this: 


1:* This is a sample file 
1:* This is a sample edit file 


5. Press CTRLCC_) to continue to the next example. 


Example 8: Replace Template ((F5)) 


Using the Replace Template function, (F5), replace the 

template with whatever characters are displayed in the 

new line. 

1. At the EDLIN prompt, press (2_) (ENTER). The screen 
looks like this: 


2:*The editing keys are easy to use 
Bits 


162 


Section IIT / EDLIN 


2. Type 
Replacing the template 


Then press (F5). Notice that the @ symbol appears after 
the last character and the cursor moves to the next line: 


2:*The editing keys are easy to use 
2:*Replacing the template@ 


After you press (F5), all the characters displaved in the 
new line replace those in the template. This is similar to 
pressing (ENTER). However, there is one important dif- 
ference. With (F5), the displayed characters go only to 
the template for further editing; they do not go to the 
requesting program. 

3. Press the Copy All function key, (F3). The screen looks 
like this: 
2:*The editing keys are easy to use 
2:*Replacing the template@ 

Replacing the template 


As you can see, the new sentence is now the template. 


4. Press €TRL)CC ) to void any changes and continue to 
the next example. 


Note: Pressing (ENTER) immediately after pressing (F5) 
empties the template. 


Example 9: Enter Line ((ENTER)) 
Whenever you press (ENTER), the displayed characters 
become the template and are sent to the requesting 
program, 
1. At the EDLIN prompt, press (2_) (ENTER). The screen 
looks like this: 


2:*The editing keys are easy to use 
2:*_ 
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2. 


aS 


Press the Copy to Char key, (F2), and then type a. The 
screen shows 


2:*The editing keys are easy to use 
2:*The editing keys - 


. Then type 


simplify editing tasks (ENTER 
The screen looks like this: 


2:*The editing keys are easy to use 
2:*The editing keys simplify editing tasks 


* 


Notice that after you press (ENTER), the EDLIN prompt 
returns to the screen. 


_ Press C2_) (ENTER). The screen looks like this: 


2:*The editing keys simplify editing tasks 
Zia 


As you can see, Line 2 now contains the new sentence 
you entered. 
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EDLIN Commands 


In addition to the editing keys, which are ideal for making 
changes and corrections to individual lines, EDLIN also 
supports many powerful commands that let you manipu- 
late an entire file or several lines at a time. 


Most EDLIN commands follow a certain format and con- 
form to certain rules. Before proceeding, review these: 


* Except for End Edit and Quit, EDLIN commands are 
preceded and/or followed by parameters (parameters 
are discussed further later). 


* EDLIN commands and parameters may be entered 
in any combination of upper-case or lower-case 
characters. 


¢ Except for the Edit Line command, EDLIN commands 
are a single letter. 


* You can indicate line numbers relative to the current 
line. A minus sign (— ) indicates lines that precede the 
current line. A plus sign ( + ) indicates lines that follow it. 
For example: 


—10,+10L CENTER) 


lists the 10 lines immediately preceding the current line, 
the current line, and the 10 lines immediately following 
the current line. 


e 


Multiple commands can be entered in the same com- 
mand line without any special delimiting characters. The 
exceptions are: 


* when you use the Edit Line command for a single line 
* when you use the Search and Replace command 


In the first case, you must use a semicolon to separate 
the commands. For example, the multiple command: 
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15;-—5,+5L (ENTER 
edits Line 15 and then displays Lines 10 through 20. po 


In the second case, press CTRE)CZ_) (instead of (ENTER) ) 
after the string to be replaced. For instance, the multiple 
command: 


SThis string@TRDCZ )—5, + 5b 


searches for the string This string and then displays the 
five lines that immediately precede the matched string 
and the five lines that immediately follow it. If the search 
fails, then EDLIN displays the numbers of the relative 
lines. 


EDLIN commands can be entered with or without a 
space between the line number and the command. For 
example, the delete command 6D is the same as 6 D. 


Control characters (such as @TRDCC_) and CTRDCZ_)) 

can be inserted into text and even used for the Search 

and Replace commands. To do this, first press om 
(CTRL)CV_) and then the desired control character. —_ 


Delimiters (spaces or commas) are required only be- 
tween adjacent line numbers. You may want to use them, 
however, to separate commands and parameters for 
better readability. 


e 


Commands become effective after you press (ENTER). 


* For commands that produce a large amount of display 
output, you should press CTRDCS) or (OLD). This 
suspends the display so you can read it. Press CTRUICOQ_) 
or to continue display output. 


* You may stop EDLIN commands by pressing CTRDCC ). 
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The EDLIN commands are summarized in the following 
table. 


Command Purpose 


Edits the specified line 
Appends lines 
Copies lines 
Deletes lines 
Ends editing 
Inserts lines 
Lists text 
Moves lines 
Pages text 
Quits editing 
Replaces lines 
Searches text 
Transfers text 
Writes lines 


GAY ROVET“MIOPS 
® 


Most EDLIN commands require you to specify a line num- 
ber, a string, or a range of lines to be affected by the 
command. These are the “command parameters.” Com- 
mand parameters may vary according to the EDLIN com- 
mand, but, generally, they are as follows. 


line (line number) 


This parameter denotes that you must indicate a line 
number (which isn’t always a numeral, as you'll see short- 
ly). You separate line numbers from the command, the 
parameters, and other line numbers. The valid separators 
are the comma and the space. 


You may specify a line in one of three ways: 


* Anumber less than 65534. If you specify a number larger 
than the number of existing lines, EDLIN adds a line to 
the file. 


* A period (.), which indicates the current line. This is the 
last line edited, not necessarily the last line displayed. 
The current line is always marked on vour screen by 
an asterisk (*) between the line number and the first 
character. 


¢ A pound sign (#), which indicates the line immediately 
following the last line edited. EDLIN adds a line to the 
file, as it does if you specify a number larger than the last 
line number. 
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If you do not include the /ime parameter in an EDLIN 
command, EDLIN substitutes that command’s default 


value. fo 


string (a group of characters) Se 


This parameter represents a portion of text EDLIN is to 
find, replace, delete, or use to replace other text. Use this 
parameter only with the Search and Replace commands. 
End each string with CTRL)CZ_). Do not include spaces 
between strings or between a string and the command 
letter (unless you want those spaces to be part of the 
string). 
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Append Lines (A) 


[number|A 


Parameter: 


Example: 


Adds the specified s2zumber of lines from disk to the file 
being edited in memory. The lines are added at the end of 
the file. 


This command is meaningful only if the file being edited is 
too large to fit into memory. Before using this command, 
you must write the portion of the file that was loaded into 
memory (and which has been edited) to disk. Refer to the 
Write Lines command. 


When the Append command has read the last line of the 
file into memory, EDLIN displays the message 


End of input file 


If you omit the 72zzmber of lines, EDLIN appends lines until 
available memory is 75% full. However, if memory is 
already 75% full, EDLIN does nothing. 


100A 


appends 100 lines from the disk to the file in memory. 
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Copy Lines (C) 
[line1]| ,line2],line3| ,count|C 


Parameters: 


Examples: 


Copies all lines ranging from /i7e7 to /ine2, placing them 
immediately ahead of /ie3. Using the coz parameter, 
you can copy the lines as many times as vou want. 


Ifyou omit /i7e7 or line2, EDLIN copies the current line. If 
you omit the cout, EDLIN copies the line(s) only once. 


Note: If you omit the /#e/ parameter, your command 
must include a comma immediately preceding the /i7e2 
parameter. 


The file is renumbered automatically after the copy and 
the first line copied becomes the current line. For 
example: 


3,9,12C 


copies Lines 3-9 to Line 12. Line 12 becomes the current 
line. 


Note: Line numbers must not overlap. If they do, EDLIN 
displays an error message. Also, the plus and minus signs 
signs are not allowed in the cou field. 


Assume that the following file exists and is ready to be 
edited. (This file is used for the next few pages. If vou want 
to create it, see the Insert command. ) 


: This sample file 

: shows what happens 

: when you use 

: the Copy command 

: to copy text in your file. 


ahWNM — 


You can copy this entire block of text by typing this at the 
EDLIN prompt: 


1,5,6C 


a 
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Almost instantly the prompt reappears to indicate that the 
command was executed. If you wish to see the result, type 


L (ENTER). The screen shows 


1: This sample file 
2: shows what happens 
3: when you use 
4: the Copy command 
5: to copy text in your file. 
6:*This sample file 
7: shows what happens 
8: when you use 
9: the Copy command 

10: to copy text in your file. 


Notice that the first line copied becomes the current line. 


Ifyou want to insert lines between other lines, use /77e3 to 
specify the line before which you want the text copied. For 
example, assume that you want to insert Lines 5-8 before 
Line 3 in the following file: 


: This sample file 

: shows what happens 

: when you use the Copy command 
: to copy text in your file. 

: If you so choose, 

: you may also insert 

: a group of lines within 

: other parts of the file. 

: The copy command 

: is versatile. 


SOON OOA WN — 


= 
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The command 5,8,3C (ENTER) results in the following file: 


1: This sample file 
2: shows what happens er” 


3:*If you so choose, 

4: you may also insert 

: a group of lines within 

: other parts of the file. 

: when you use the Copy command 

: to copy text in your file. 
9: If you so choose, 

10: you may also insert 

11: a group of lines within 

12: other parts of the file. 

13: The copy command 

14: is versatile. 


ee: 


Delete Lines (D) 


[line1],line2|D 


Parameters: 


Examples: 


Deletes /ine7 or all lines within the range /ine1 to line2 
from a file. 


EDLIN automatically renumbers the lines to maintain con- 
secutive numbering in the file. 


You may omit the /ize7 parameter, as in 
Jine2D (ENTER 


If you do, EDLIN starts deleting at the current line and 
ends at /ine2. Your command line must include the com- 
ma before /ime2 to indicate you are omitting /ine7. 


You may omit the /i#7e2 parameter, as in 
line1D or line1,D 

If you do, EDLIN deletes only /ive7. 

If you omit /ine7 and /ine2, as in 

D 


EDLIN deletes only the current line. 


Assume that the following file exists and is ready to be 
edited. Line 30 is the current line: 


: This sample file 

: shows how 

: the Delete command functions. 
: All that is required 

: in most cases 


arWND — 


26: is to specify 

27: a number of lines 

28: to be deleted; 

29: deleting can often help 
30:*to clean up your files. 
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Type 
5,25D (ENTER 
The result is 


1: This sample file 

2: shows how 

3: the Delete command functions. 
4: All that is required 

5:*is to specify 

6: a number of lines 

7: to be deleted; 

8: deleting can often help 

9: to clean up your files. 


To delete line 4 in the above file, type 
4D (ENTER 
The result is 


1: This sample file 

2: shows how 

3: the Delete command functions. 
4:*is to specify 

5: a number of lines 

6: to be deleted; 

7: deleting can often help 

8: to clean up your files. 


To delete the current and the following two lines, type 
,6D (ENTER 
The result is 


1: This sample file 

2: shows how 

3: the Delete command functions. 
4:+deleting can often help 

6: to clean up your files. 
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To delete only the current line, type 
D (ENTER 
The result is 


1: This sample file 

2: shows how 

3: the Delete command functions. 
4:*to clean up your files. 


Edit Line 


Cine) 


[line] 


Parameters: 


Example: 


Lets you load the specified /ine for editing. 


EDLIN displays the specified line and — on the next line 
— the line’s number (without text) to indicate the line is 
ready for editing. You can then use the editing keys, 
control keys, and the EDLIN commands. 


If you omit the /ive (vou only press (ENTER) ), EDLIN loads 
the line that immediately follows the current line. 


Ifyou don’t need to change the line, and the cursor is at the 
beginning or end of the line, press (ENTER) to accept the 
line as is. 

If you press (ENTER) while the cursor is in the middle of a 


line, EDLIN erases the rest of the line. 


Finally, if you wish to cancel any changes made to a line, 


press (F8). 


Assume that the following file exists and you wish to edit 
Line 4: 

1: This is a sample file 

2: used to show 

3: the editing of line 

4:*four. 


Type 4 (ENTER) at the EDLIN prompt. The screen looks like 


this: 
*4 
4: four 
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Press (INSERT), type number followed by a single space, 
and press (INSERT) again. Then, to copy the rest of the line, 
press the Copy All editing key, (F3). The screen shows 


*4 
4:*four 
4:*number four. 


At this point you may: 
* Save the changed line by pressing (ENTER). 


* Type more text at the end of the line (the insert mode is 
in effect whenever the cursor is at the end of the line). 


* Press (F5) (Replace Template) to further edit the line. 


* Press or CTRL) CC_) to cancel the changes made to 
the line. 
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End Edit (E) 


E 


Ends the EDLIN program and saves the edited file. 


When EDLIN saves the edited file, it uses the drive speci- 
fication, filename, and extension you specified when you 
started EDLIN. (If you want, you can use Copy to transfer 
the file to another drive.) 


If you edited an existing file (rather than a newly created 
one), EDLIN also saves the original file (unedited file). In 
the original file’s case, however, EDLIN gives the file the 
extension .bak (for backup). 


When you enter the End Edit command, EDLIN appends a 
CTRL)C Z_) character to serve as the end-of-file mark. 


After you enter the End Command, control returns to 


MS-DOS. The system prompt (probably A> ) is displayed. 


Warning: Be sure the disk contains enough free space to 
save the entire file. If it does not, EDLIN saves only part of 
the file; the rest is lost. If this occurs to a file, the portion 
saved has the file extension of .$$$. 
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Parameters: 


Examples: 


Inserts lines of text immediately before the specified /ive. 
Also, when you create a new file, you must enter the I 
command to begin writing text. 


Text begins with Line 1. Successive line numbers appear 
automatically each time you press (ENTER). 


EDLIN remains in the Insert mode until vou press 
(CTRL)CC ). After you press C€_), the line im- 
mediately following the insertion becomes the current 
line. EDLIN automatically increments all line numbers that 
follow the insertion as necessary. 


If you use a period (.) to specify the dine — or if you omit 
the dine parameter — EDLIN uses the current line. 


If you use a pound sign (#) to specify the /ize — or if the 
line is any number larger than the number of the last line 
— EDLIN appends the lines to the end of the file. In this 
case, the last line inserted becomes the current line. 


Assume that the following file exists and is ready to be 
edited: 


1: This is a sample file 

2: to show what happens 

3: when using the Insert command 
4: in your files 


To insert text before a specific line that is not the current 
line, type /inel (ENTER). For example, tvpe 


31 (ENTER 


The result is 


i 
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Now, type the new text for Line 3: 
3: to the line numbers 


To continue text insertion, press (ENTER). EDLIN displays a 
new line number. Type 


(how they are renumbered) (ENTER 


Then return to the EDLIN prompt by pressing CTRL)CC _). 
Type L (ENTER) to display the result: 


1: This is a sample file 

2: to show what happens 

3: to the line numbers 

4: (how they are renumbered) 
5:*when using the Insert command 
6: in your files 


To insert a line immediately before the current line, type 
| (ENTER) at the EDLIN prompt. The screen shows 


She 
Now type 
every time you insert new lines (ENTER 


When EDLIN displays the number for the next line, press 
CTRL)CC ) to return to the EDLIN prompt (°). Type L 
ENTER) to list the file. The screen looks like this 


1: This is a sample file 

2: to show what happens 

3: to the line numbers 

4: (how they are renumbered) 
5:*every time you insert new lines 
6: when using the Insert command 
7: in your files 


To add lines to the end of the file, type 
81 (ENTER 
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The screen shows 
8:... 
Enter the following new lines 


8: The Insert command 
9: can be used 

10: to add new lines 

11: to the end of your file 


Press (CTRL)CC_) when the number for Line 12 is dis- 
played: Then, at the EDLIN prompt, type L (ENTER) to list 
the file. The screen looks like this: 


: This is a sample file 

: to show what happens 

: to the line numbers 

: (how they are renumbered) 

: every time you insert new lines 
: when using the Insert command 
: in your files 

: The Insert command 

: can be used 

: to add new lines 

: to the end of your file 


“SOON OOAARWDND — 


at ok 
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List (L) 


[line1]| ,line2|L 


Parameters: 


Displays all lines within the range /ime1 and line2. 


Note: If /izeZ is more than 11 lines before the current line, 
EDLIN displays the same lines it does if you omit both 
parameters. 


You may omit /ine1, as in 
line2 (ENTER 


If you do, the display begins before the current line and 
ends with /ine2. The comma is required to indicate that 
you omitted line. 


You may omit /ime2, as in 
line? (ENTER 
If you do, EDLIN displays 23 lines, starting with /ine7. 


If you omit both parameters, EDLIN displays 23 lines — 
the 11 lines immediately preceding the current line, the 
current line, and the 11 lines immediately following the 
current line. If fewer than 11 lines precede the current 
line, EDLIN displays more lines that follow the current line 
to make a total of 23 lines. 
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Examples: 
—_ Assume that the following file exists and is ready to be 
edited: 
1: This is a sample file 
2: used to show the List command. 
3: See what happens when you use 
4: List (L) with different parameters 
5: or without any 
15:*The current line contains an asterisk. 
26: to edit text 
27: in your file. 
oo To list a range of lines without reference to the current 
line, type 
line,lineL (ENTER 
For example, type 
2,5L (ENTER 


to produce the following display: 


2: used to show the List command. 
3: See what happens when you use 
4: List (L) with different parameters 
5: or without any 


To list a range of lines beginning with the current line, 
type 


line L (ENTER 


183 


Section II / EDLIN 


For example, type 
.,26L (ENTER 
to produce this display: 


15:*The current line contains an asterisk. 


26: to edit text 


To list a range of 23 lines centered around the current line, 
you need only type L (ENTER). The screen shows 


4: List (L) with different parameters 
5: or without any 


13: The current line is listed in the middle of the 
range. 

14: The current line remains unchanged by the L 
command. 

15:*The current line contains an asterisk. 


26: to edit text. 
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Move Lines (M) 


[Jine1]| ,line2],line3M 


Parameters: 


Example: 


Moves all lines within the range /ine7 to line2 to the line 
immediately preceding /ine3. line1 becomes the current 
line. 


Use the Move command to move a block of lines from one 
place in the file to another. 


If you omit the /ize7 parameter, the /ime2 parameter, or 
both, EDLIN uses the current line. 


It renumbers the lines according to the direction of the 
move. For example: 


,+25,100M (ENTER 


moves the text from the current line + 25 to Line 100. If 
the line numbers overlap, EDLIN displays the message 


Entry error 


To move Lines 20-30 to Line 100, type 
20,30,100M (ENTER 
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Page (P) 


[line1]{ ,line2|P 


Parameters: 


Example: 


Pages through a file 23 lines at a time or lists the specified 
block of lines. 


You may omit the /imeZ parameter, as in 
Jine2P (ENTER 


If you do, EDLIN uses the current line number + 1, unless 
the current line is Line 1. The comma is required to 
indicate that you omitted the /ime1 parameter. 


You may omit the /ime2 parameter, as in 
line7P (ENTER 
If you do, EDLIN lists 23 lines. 


The last line displayed becomes the current line. This 
command differs from the List command in that the 
Page command changes the current line (to the last line 
displayed). 


To display Lines 10 though 15, type 
10,15P 

To display Lines 20 through 42, type 
20P 


EDLIN displays the specified line (Line 20) and the next 22 
lines. Line 42 becomes the current line. 


Then, to display Lines 43 through 65, tvpe 
P (ENTER 


EDLIN displays the current line + 1 (Line 43) and the next 
22 lines. Line 65 becomes the current line. 
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Quit (Q) 


Example: 


Quits the editing session without saving any changes you 
may have made to the file. 


EDLIN prompts you to make sure you don't want to save 
the changes. Press if you want to quit the editing 
session without saving any changes. Press CN_) to con- 
tinue editing. 


*Q 
Abort edit (Y/N)?- 
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Replace String (R) 
[line1][ ,line2]|?|Rstring1 CTRL) Z_)string2 


Parameters: 


Replaces all occurrences of string1 with strig2. The re- 
placement is limited to the lines between /ime/ and /ine2. 


Notice that you must terminate s/rig1 by pressing 
(CTRL)CZ_), then begin stri7g2 immediately following the 
(CTRL)CZ_) character. Terminate s¢rimg2 by pressing 
another (CTRL) CZ_) or (ENTER). 


Each time Replace finds strig7, it replaces the string1 
with string2. It displays the line in which it has made a 
replacement. If a line contains more than one replace- 
ment, Replace displays it once for each occurrence. 


When all occurrences of srig7 in the specified range are 
replaced with string2, the Replace command terminates, 
and the EDLIN prompt (" ) reappears. 


If you omit /ize7, Replace starts the search at the line that 
immediately follows the current line; it stops at /i77e2. 


If you omit /777e2, Replace continues the search to the end 
of the file. 


Therefore, if you omit /i7e7 and /ine2, searching begins at 
the line that immediately follows the current line and ends 
at the end of the file. 


? tells Replace to prompt you with O..? each time it 
modifies a line. Press to accept the change. Press 
CN_) to reject it. In either case, the search continues, 
starting at the next line. 

If you omit string2, EDLIN deletes all occurrences of 
string! in the specified line range. 

If you omit string 1 and string2, EDLIN uses the most 
recent string specified with a Search (or Replace) com- 
mand as string, and the most recent string specified in a 
Replace command as siri7g2. 
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Examples: 


Assume that the following file exists and is ready for 
editing: 


1: This sample file 

2: shows how the Replace and Search commands 
work. 

: When you use Replace and Search 

: certain words and phrases 

: may be exchanged for 

: other words and phrases 

: in your file. 


NOOR W 


To replace all occurrences of and with or in the above file, 
type 


1,7Rand(CTRL)CZ _)or(ENTER 
The result is 


2: shows how the Replace or Search commands 
work. 

2: shows how the Replace or Search commors work. 

3: When you use Replace or Search 

4: certain words or phrases 

6: other words or phrases 


Note that Lines 1,5, and 7 are not displayed because they 
are not changed. Line 2 is displaved twice because the and 
string occurred by itself and within the word commands. 
This is an unwanted substitution. 


To avoid unwanted changes, you can include the ? pa- 
rameter. For example, type 


2,7?RandCTRL)CZ )or(ENTER 


Now, whenever Replace finds the and string, you have the 
Opportunity to accept or reject the change. 
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Search Text (S) 
[line1][ ,line2|[?|Sstring(ENTER) 


Parameters: 


Searches all lines within the range /ine1 to line2 for each 
occurrence of the text string. 


You must terminate the sfring by pressing (ENTER). 


If you omit the question mark (?), Search displays the first 
line (in the specified range) that matches the s¢/ring. That 
line becomes the current line, and the Search command 
terminates. 


If the string does not occur between /ine/ and /ine2, 
Search displays the message 


Not found 


If you include the question mark, Search displays the first 
line that contains the séring. It then prompts you with the 
message 


O.K.? 
If you press either or (ENTER), the line becomes the 


current line, and the search terminates. If you press any 
other key, the search continues until it finds another 
match or searches all lines. 


You may omit the /i7e7 parameter, as in 
Jine2Sstring (ENTER 


If you do, the search begins at the line that immediately 
follows the current line. 


You may omit the /i#77e2 parameter, as in 
line1Sstring (ENTER) or /ine7,Sstring (ENTER 


If you do, Search uses the pound sign (#), which indicates 
the line after the last line of the file. Omitting /i77e2 is the 
same specifying /inel ,#Sstring. 
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If you omit the string, Search uses the last search string that 
was used in a Replace or Search command. If there is no 
search string (no previous search or replace has been 
done), the command terminates immediately. 


Notes: 


i 


Search looks for the string exactly as you specify it in 
the command. Therefore, enter the string in the 
same combination of upper- and lower-case charac- 
ters as it appears in the text. 


2. Begin the search strig immediately after the S in the 
command line. End it by pressing (ENTER). Any 
spaces you include are considered part of the search 
string. 

3. In multiple line commands, terminate the s/ring 


with (TRDCZ_), instead of (ENTER). You may then 
follow the string with another command, in the next 
character position. 


Assume that the following file exists and is ready to be 
edited. Line 5 is the current line. 


1: This sample file 
2: shows how the Search command functions. 
3: to locate and point out 
4: a specified string 
5:*in a range of lines 
6: of your file. 
7: The Search command 
8: may include the optional parameter ? and 
9: two line parameters for the range. 
10: You should also specify the string and press 
ENTER. 
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To search for the first occurrence of the string and, type 
1,10 Sand(ENTER 
The screen shows 


2: shows how the Search command 
functions. 


* 


because the string and is part of the word command. Line 
2 then becomes the current line. 


This is probably not the and for which you were looking. 
To find the next occurrence of and, type 


S (ENTER 
at the EDLIN prompt. The screen looks like this: 


* 110 Sand 
2: shows how the Search command 
functions. 
*S 
3: to locate and point out 


Line 3 becomes the current line. 
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To search through several occurrences of a string until 
you find the correct one, type 


1, ? Sand 
The result is 
* 1,10 Sand 
2: shows how the Search command 
functions. 
O.K.? N 
3: to locate and point out 
O.K.?.N 
7: The Search command 
O.K.? N 
8: may include the optional parameter ? 
and 
O.K.? 


The search continues until you press or the file runs 
out of lines. At that time, Search displays the message 


Not found 
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Transfer Lines (T) 
[ line|T| drive|filename 


Parameters: 


Example: 


Inserts (merges) the contents of a specified file into the 
file being edited. The transferred file is inserted just ahead 
of the specified /ine or current /ine. 


After the file is inserted, the merged file is renumbered 
automatically. 


Note: The file to be transferred is read from the current 
directory of the specified or the default drive. If you issued 
a path when EDLIN was started, that path serves as the 
current directory. All subsequent Transfer Lines com- 
mands use that directory. 


If you omit the /ive, then the file contents are inserted 
ahead of the current line. 


10TB:myfile 


insert the contents of B:Myfile into the file being edited. 
B:Myfile is inserted just before Line 10. 
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Write Lines (W) 


[number|W 


Example: 


Writes a specified s2zmber of edited lines from memory to 
disk. Writing begins with Line 1. 


This command is meaningful only if the file you are edit- 
ing is too large to fit into memory. When you start EDLIN, 
files are loaded until memory is 75% full. To edit the rest 
of your file, you must first write edited lines in memory to 
disk. Then you can load the unedited lines from disk into 
memory, using the Append command. 


Note: If you omit the mzumber, EDLIN writes lines until 
25% of memory is freed. If at least 25% already is freed, 
EDLIN takes no action. All lines remaining in memory (not 
written to disk) are renumbered starting with Line 1. 


100W 


writes Lines 1 through 100 to disk and renumbers the file 
in memory, starting with Line 101 as Line 1. 


Error Messages 


When you enter an invalid EDLIN command, or fail to 
follow the proper syntax, EDLIN displays one of the fol- 
lowing error messages: 


Cannot edit .BAK file — rename file 


Cause: You are trying to edit a file with an exten- 
sion of .bak. You cannot do so because 
EDLIN reserves the .bak extension for back- 
up copies. 


Cure: If you need the .bak file for editing pur- 
poses, you must either RENAME the file 
with a different extension or COPY it, giving 
it a different extension. 
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No room in directory for file 


Cause: 


Cure: 


Entry Error 


Cause: 


Cure: 


You are trying to create a file, but either the 
file directory is full or you are specifving an 
illegal disk drive or filename. 


Check the command line that started EDLIN 
for either an illegal filename or an illegal 
drive specification. If the command is no 
longer on the screen, and if you have not yet 
typed a new command, you can recover the 
command by pressing the Copy All key, (F3). 


If the command line contains no illegal en- 
tries, run the CHKDSK program for the 
specified disk drive. If the status report 
shows that the disk directory is full, remove 
the disk. Insert and format a new disk. 


The last command typed contained a syntax 
error. 


Re-enter the command, using the correct 
syntax. 


Line too long 


Cause: 


Cure: 


During a Replace command, the string 
given as the replacement caused the line to 
expand beyond the limit of 253 characters. 
EDLIN aborted the Replace command. 


Divide the long line into two lines, then try 
the Replace command again. 


Disk Full — file write not completed 


Cause: 


You entered the End command, but the 
disk does not contain enough free space for 
the whole file. EDLIN aborted the End com- 
mand and returned you to the operating 
system. Some of the file may have been 
written to the disk. 
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Cure: Only part (if any) of the file is saved. Delete 
that part of the file and restart the editing 
session. The file will not be available after 
this error. Before you begin any editing 
session, be sure the disk has sufficient free 
space for the file. 


Invalid drive name or file 


Cause: You specified an illegal drive or filename 
when you started EDLIN. 


Cure: Specify a legal drive or filename. 
Filename must be specified 


Cause: You did not specify a filename when you 
started EDLIN. 


Cure: Specify a filename whenever vou start 
EDLIN. 


Invalid Parameter 


Cause: You specified a switch other than /B when 
starting EDLIN. 


Cure: Specify the /B switch when you start EDLIN. 
Insufficient memory 
Cause: There is not enough memory to run EDLIN. 


Cure: Free some memory by writing files to disk 
or by deleting files before restarting EDLIN. 
Use the Write command and then the 
Append command. 

File not found 


Cause: The filename specified during a Transfer 
command was not found. 


Cure: Specify a valid filename when issuing a 
Transfer command. 
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Must specify destination number 


Cause: You did not specify a line number in a Copy 
or a Move command. 


Cure: Re-enter the command, including a destina- 
tion line number. 


Not enough room to merge the entire file 


Cause: There is not enough room in memory to 
hold the file during a Transfer command. 


Cure: Free some memory by writing some files to 
disk or by deleting some files before you 
can transfer the file. 


File creation error 


Cause: The EDLIN temporary file cannot be 
created. 
Cure: Verify that the directory has enough space 


to create the temporary file. Also, be sure 
that the file does not have the same name as 
a subdirectory in the directory where the 
file to be edited is located. 
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Introduction 


This section describes how to use the linker program, 
MS™-LINK. You should read all of the Chapter 1, “Basic 
Information,” before you use the linker. Advanced users 
may also want to read the Chapter 2, “Technical Informa- 
tion.” Chapter 3 contains the linker error messages. 


If you are not going to compile and link programs, you do 
not need to read this section. 


System Requirements 
The linker requires the following: 
* At least SOK bytes of memory. 


40K bytes are for code and data; the remaining 10K bytes 
are for run space. 


* One disk drive, if output is sent to the same disk from 
which input was taken. 


* Two disk drives, if output is sent to a different disk. 


Because the linker does not allow time to swap disks 
during operation on a 1-drive configuration, the use of 
two disk drives is more practical. 
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Overview of the Linker 


When you write a program, you do so in source code. 
Then, by passing the source code through a compiler or 
an assembler, you produce an object module. This object 
module, however, cannot be understood by the computer 
directly. 


To produce “machine language,” code that the computer 
can understand, you must pass the object module through 
the link process. 


Additional functions of the linker are summarized below. 


Linking Object Modules and 
Producing a Run File 


You may wish to link (combine) several separately pro- 
duced object modules and run them as one program. The 
linker enables you to do this. It produces one relocatable 
load module, or “run” file (also called an .exe or execut- 
able file). 


Resolving External References 


In addition to containing internal references, modules 
that you link may contain “external references” (refer- 
ences to symbols that are defined in the other modules). 
As it combines modules, the linker resolves all external 
references (makes sure they are defined). If any external 
reference is not defined in the object modules, the linker 
searches up to eight library files for the definition. 


Producing a List File 


The linker also produces a List file, which shows external 
references resolved and displays any error messages. 


The following diagram illustrates the various parts of the 
linker’s operation: 
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Nou-Assembly Assembly Source 
Source - 


libraries listing 
lib st - 
Up to 8 libraries 


can be searched 


Run file 
Used only if run VM.TMP exe 
file is larger 


than memory 


The VM.TMP (Temporary) File 


The linker uses available memory for the link session. If 
the files to be linked create an output file that exceeds 
available memory, the linker creates a temporary file, 
names it VM.TMP, and puts it on the disk in the current 
drive. It displays le 


VM.TMP has been created. 
Do not change diskette in drive d: 
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Once this message is displayed, you should not remove 
the disk from the current drive until the link session ends. 
If you do remove the disk, the operation of the linker will 
be unpredictable, and the linker might display the error 
message 


Unexpected end of file on VM.TMP 


The contents of VM.TMP are written to the file you name at 
the Run File: prompt (see “Command Prompts). VM.TMP 
is a working file only; the linker deletes it automatically at 
the end of the linking session. 


Warning: Do not use VM.TMP as a filename. If you have a 
file named VM.TMP on the current drive and the linker 
requires the VM.TMP file, it destroys the existing VM.TMP 
file and creates a new VM.TMP. 


Definitions 


Some of the terms used in this section are explained 
below to help you understand how the linker works. 
Generally, if you are linking object modules compiled 
from BASIC, Pascal, or another high-level language, you 
do not need to know these terms. If you are writing and 
compiling programs in assembly language, however, you 
must understand the linker and the definitions described 
below. (Chapter 2, “Technical Information,” also contains 
useful information on how the linker works. ) 


In MS-DOS, memory can be divided into “segments,” 
“classes,” and “groups.” The diagram below illustrates 
these concepts. 
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Segment Segment Segment | Segment | Segment 
1 2 3 4 5 
a 
Segment | Segment 12 |Segment| Segment 14| Segment] Segment 
11 13 15 16 
Segment 17} Segment 18 | Segment 19 
20 21 22 


shaded area = a group (64K bytes addressable) 


Memory 
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Example: 
Segment Class 
Name Name 
Segment 1 PROG.1 CODE 
Segment 2 PROG.2 CODE 
Segment 12 PROG.3 DATA 


Note that segments must have different segment names 
but may or may not have the same class name. Segments 
1, 2, and 12 form a group; the group address is the lowest 
address of Segment 1 (the lowest address in memory). 
Definitions of the terms segment, class, and group follow. 


A segment is a contiguous area of memory up to 64K bytes 
long. It can be located anywhere in memory on a para- 
graph (16-byte) boundary. The contents of a segment are 
addressed by a segment address and an offset within that 
segment. Segments can overlap. 


A group is a collection of segments that fit within a 64K 
byte area of memory. The segments do not need to be 
contiguous (see illustration). The group address is the 
lowest address of the lowest segment in that group. At link 
time, the linker analyzes the groups, then references the 
segments by the group address. A program may consist of 
one or more groups. 


If you are writing in assembly language, you may assign 
the names of groups in your program. In high-level lan- 
guages, the compiler automatically assigns the names. The 
linker checks to see that the object modules of a group 
meet the 64K-byte constraint. 
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Class 


A class is a collection of segments. The naming of seg- 
ments to a class controls the order and relative placement 
of segments in memory. In an assembly-language pro- 
gram, you assign names to the classes. In high-level lan- 
guage programs, the compiler automatically assigns the 
names. 


All segments assigned to the same class are loaded into 
memory contiguously, The segments are ordered within a 
class in the order in which the linker encounters them in 
the object files. One class precedes another in memory 
only if a segment for the first class precedes all segments 
for the second class in the input to the linker, Classes may 
be any size, and groups may span classes. 

Refer to Chapter 2, “Technical Information,” for informa- 
tion on how to assign group and class names and on how 
the linker combines and arranges segments in memory. 


Command Prompts 


After you start the linker (see “Starting the Linker” later in 
this chapter), a series of four prompts appears on your 
display. When you have typed a response to a prompt and 
pressed (ENTER), the next prompt appears. 


After you answer the last prompt, the linker begins linking. 
If it finishes successfully, the linker exits and the MS-DOS 
system prompt is displayed. If an error occurs, the linker 
displays the appropriate error message. 


The linker prompts you for the names of the object, run, 
and list files, and for libraries. Use a standard MS-DOS 
pathname to reference each file. 


The prompts are discussed below in the order they 
appear. Defaults are shown in square brackets (|__|) fol- 
lowing the prompt. To select a default, simply press 
in response to a prompt. The Object Modules: 
prompt is the only one that requires you to type a path- 
name. 
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Object Modules [.OBJ]: 


Enter a list (one or more) of the object modules to be 
linked. If an object module has an extension other than 
obj, specify it. If you do not, the linker assumes it is .obj. 


Separate module names from one another with a blank 
space or a plus sign (+). 


Remember, the linker loads segments into classes in the 
order encountered. You can use this information to set the 
order in which the linker reads the object modules. Refer 
to Chapter 2, “Technical Information,” for more informa- 
tion on this process. 


Run File [first object pathname.EXE|: 


Enter a pathname. The linker creates a file of that name to 
store the run file that results from the link session. It 
assigns the run file the extension .exe, even if you specify 
an extension other than .exe. 


If you do not enter a pathname in response to this prompt, 
the linker uses the first pathname typed in response to the 
Object Modules: prompt. 


Example: 
Run File [PROG1.EXE]: B:payroll/P 


This response directs the linker to create the run file 
Payroll.exe on Drive B. Because the /P switch is included 
(see “Linker Switches” later in this chapter), the linker 
pauses to let you insert a new disk to receive the run file. 


List File [NUL.MAP]: 


Enter a pathname. If you do not specify an extension, the 
linker assigns the extension .map. The list file contains an 
entry for each segment in the object modules. Each entry 
shows the offset for that segment in the run file. 


If you do not enter a pathname in response to this prompt, 
the linker uses the default value (NUL.MAP) and thus does 
not produce a list file. 


207 


Section IV / The Linker 


Libraries [.LIB]: 


Enter up to eight library filenames or simply press (ENTER). 
(Pressing only tells the linker to search for default 
libraries in the object modules.) Library files must have 
been created by a library utility. 


If you do not specify an extension, the linker assumes it is 
Jib. 


Separate library pathnames with blank spaces or plus 
signs (+ ). 


The linker searches library files in the order listed to 
resolve external references. When it finds the module that 
defines the external symbol, the linker processes that 
module as another object module. 


If the linker cannot find a library file on the disks in the 
disk drives, it displavs 

Cannot find library library file 

Type new drive letter: 


Press the letter for the drive designation (for example, 


CB )). 


Command Characters 


Plus Sign 


The linker provides three command characters. 


Use the plus sign (+ ) to separate entries and extend lines 
as needed. (A blank space may be used instead to separate 
entries. ) 

If the response to the Object Modules: or Libraries: 
prompt is too long to fitona line, type + at the end 
of the line. The prompt appears again, and you can con- 
tinue typing the response. After listing all the modules, 


press (ENTER). 
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At any time after the first prompt (Run File:), you may 
select default responses to the remaining prompts. To do 
so, type ; (ENTER). This eliminates the need to press 
repeatedly. 


Note: Once you have entered the semicolon, you can no 
longer respond to any of the remaining prompts for that 
link session. Therefore, do not use the semicolon to skip 
only a few prompts. To skip prompts, use the key. 


Use C€_) to abort the link session at any time. If you 
enter an erroneous response — such as the wrong path- 
name or an incorrectly spelled pathname — you must 
press CC _) to exit the linker. Then you can restart 
the linker. 


Note: If you made an error but have not pressed (ENTER), 
use (BACKSPACE) to delete characters in that line. 


Linker Switches 


The seven linker switches control various linker functions. 
When you use switches, you may group them at the end of 
any response or scatter them at the ends of several. To 
specify a switch, type a forward slash (/) followed by the 
switch name (which you can abbreviate to the first letter). 


/DSALLOCATE 


The/D switch tells the linker to load all data at the high end 
of the data segment. If you omit /D, all data is loaded at the 
low end. 


At runtime, the DS pointer is set to the lowest possible 
address to allow the entire DS segment to be used. Using 
/D and omitting /H allows any available memory below the 
area specifically allocated within DGroup to be allocated 
dynamically by the user program and remain addressable 
by the same DS pointer. This dynamic allocation is needed 
for Pascal and FORTRAN programs. 
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/HIGH 


Note: Your application program may dynamically allocate 
up to 64K bytes (or the actual amount of memory avail- 
able) less the amount allocated within DGroup. 


The /H switch causes the linker to place the run file as high 
as possible in memory. If you omit/H, the linker places the 
run file as low as possible in memory. 


Important: Do not use /H with Pascal or FORTRAN 
programs. 


/LINENUMBERS 


/MAP 


/PAUSE 


The /L switch tells the linker to include in the list file the 
line numbers and addresses of the source statements in 
the input modules. If you omit /L, the linker does not 
include the line numbers. (If the object modules do not 
contain line number information, the linker cannot in- 
clude line numbers. ) 


The /M switch directs the linker to list all public (global) 
symbols defined in the input modules. If you omit /M, the 
linker lists only errors (including undefined globals). 


The symbols are listed alphabetically at the end of the list 
file. For each symbol, the linker lists its value and _ its 
segment:offset location in the run file. 


The /P switch causes the linker to pause in the link session 
when the switch is encountered. This lets you swap disks 
before the linker outputs the run file. If you omit /P, the 
linker does the link without stopping. 


When the linker encounters the /P switch, it displays the 
message: 


About to generate .EXE file 
Change disks <hit any key> 


Press (SPACEBAR) to resume processing. 
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Warning: Do not remove the disk that is to receive the list 
file or the disk used for the VM.TMP file, if one has been 
created. 


/STACK:size 


The /S switch lets you specify the stack size. If you omit /S, 
the linker calculates the required stack size from informa- 
tion in the object modules provided by the compiler or 
assembler. 


size can be any positive value (in decimal) up-to 65535 
bytes. If you enter a value from 1-511, the linker uses 512. 


At least one object (input) module must contain a stack 
allocation statement. If not, the linker displays the error 
message: 


WARNING: NO STACK STATEMENT 
_. /NO 


The /N switch tells the linker not to search the default 
(product) libraries in the object modules. For example, 
suppose. you are linking object modules in Pascal. If you 
specify /N, the linker does not search the library named 
Pascal.lib to resolve external references. 


Starting the Linker 


You can start the linker in any of these ways: 


* By entering responses to the individual prompts as they 
are displayed 


* By including all responses on the command line 


* By creating a file to automatically respond to the 
prompts 


“, Method 1: Keyboard Responses 
Type 
LINK 
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The linker is loaded into memory and displays the four 
prompts, one at a time. (These prompts and possible 
responses are described under “Command Prompts.”) ff ‘ 


Method 2: Responses on Command Line 


Type all prompt responses on the LINK command line. 
Separate the responses with commas. Use the following 
format: 


LINK objlist,runfile, listfile,liblist[/switch . . . (ENTER 


objlist is a list of object modules. Use a blank space or a 
plus sign to separate the module names. 


runfile is the name of the file to receive the executable 
output. 


listfile is the name of the file to receive the listing. 


liblist is a list of library modules to be searched. Use a 
blank space or a plus sign to separate the module names. 


/switch refers to optional switches. Switches may follow f 
any response list (they may immediately precede any 
comma or immediately follow the /iblist). 


To select the default for a field, simply type a second 
comma with no spaces between the two commas. 
Example: 


LINK fun + text + table + care/P/M,, 
funlist,coblib.lib (ENTER 


This command causes the linker to be loaded. Then the 
object modules Fun.obj, Text.obj, Table.obj, and Care.obj 
are loaded. The linker then pauses (because of the /P 
switch). When you press (SPACEBAR), the linker links the 
object modules and produces a global symbol map 
(because of the /M switch). It then creates a run file with 
the default name Fun.exe, creates a list file named 
Funlist.map, and searches the library file Coblib.lib. on 
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Method 3: Response File 


Type 
LINK @filespec 


filespec is the name of an automatic response file, which 
contains answers to the linker prompts. The extension is 
optional. There is no default extension. 


This method permits the command that starts the linker to 
be entered from the keyboard or within a batch file with- 
out requiring you to take any further action. 


Before using this option, you must create an automatic 
response file. This file should contain several lines of text, 
each of which is the response to a linker prompt. The 
responses must be in the same order as the linker prompts 
discussed earlier. If desired, a long response to the Object 
Modules: or Libraries: prompt may be typed on several 
lines. Use a plus sign (+ ) at the end of a line to continue 
the response on the next line. 


Use switches and command characters in the response file 
the same way as they are used for responses typed from 
the keyboard. 


When the link session begins, each prompt is displayed, in 
order, with the responses from the file. If the file does not 
contain a response for a prompt, the linker displays the 
prompt and waits for you to enter a valid response. After 
you do so, the linker continues. 


Example: 


fun text table care 
/P /M 

funlist 

coblib.lib 


The first line in this file tells the linker to load four object 
modules: Fun, Text, Table, and Care. The second line 
omits a name for the run file; this tells the linker to use the 
name Fun.exe. 
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When the linker encounters the /P switch, it pauses to let 
you swap disks. After doing so, press to con- 
tinue. Because the line includes the /M switch, the linker 
produces a public symbol map (see “Switches”. 


The third line tells the linker to name the list file 
Funlist.map. The fourth line tells it to search the library file 
Coblib.lib. 


Sample Link Session 
This sample shows you the kind of information that is 
displayed during a link session. 
In response to the MS-DOS prompt, type 


LINK 


The system displays the following messages and prompts, 
with your responses: 


Microsoft Object Linker V.2.00 
(C) Copyright 1982 by Microsoft Inc. 


Object Modules [.OBu]: io sysinit 
Run File [l1O.EXE]: /M 

List File [NUL.MAP]: PRN /L 
Libraries [.LIB]: 


Notes: 


1. Because you specify /M, the linker displays an 
alphabetical and a chronological listing of 
public symbols. 


2. By responding PRN to the List File: prompt, you 
redirect your Output to the printer. 
3. Because you specify the /L switch, the linker lists all 


line numbers for all modules. (The /L switch can 
generate a large amount of output.) 


4, Because you press (ENTER) in response to the Li- 
braries: prompt, the linker performs an automatic 
library search. 
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Once the linker locates all libraries, the linker map dis- 
plays a list of segments in the order of their appearance 
within the load module. The list might look like this: 


Start Stop Length Name 
00000H O09ECH O9EDH CODE 
QO9FOH  01166H 0777H SYSINITSEG 


The information in the start and stop columns shows the 
20-bit hex address of each segment relative to location 
zero. Location zero is the beginning of the load module. 


The addresses displayed are not the absolute addresses 
where these segments are loaded. See Chapter 2, ““Tech- 
nical Information,” for information on how to determine 
where relative zero is actually located and how to deter- 
mine the absolute address of a segment. 


Because you used the /M switch, the linker displays the 


public symbols by name and value. For example: 


ADDRESS PUBLICS_BY_NAME 
Q09F:0012 BUFFERS 

O009F:0005 CURRENT-DOS_LOCATION 
Q09F:0011 DEFAULT_DRIVE 
009F:000B DEVICE_LIST 

009F:0013 FILES 

Q09F:0009 FINAL_DOS-LOCATION 
O09F:000F MEMORY.-SIZE 

OO9F:0000 SYSINIT 

ADDRESS PUBLICS BY VALUE 
O009F:0000 SYSINIT 

O09F:0005 CURRENT_-DOS_LOCATION 
Q09F:0009 FINAL_DOS_LOCATION 
009F:000B DEVICE_LIST 

O009F:000F MEMORY-SIZE 

O009F:0011 DEFAULT_DRIVE 
QO9F:0012 BUFFERS 

009F:0013 FILES 


~ 
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Technical Information 


This chapter contains detailed information about the link- 
er that is of interest to advanced assembly language 
programmers. 


The linker is able to link files totaling one megabyte. The 
output file from the linker (a run file) is not bound to 
specific memory addresses and, therefore, can be loaded 
and executed at any convenient address by the operating 
system. The relocation information is a list of long addres- 
ses that must change when the executable image is re- 
located in memory. See “Long References” later in this 
chapter for an explanation of long addresses. 


Definitions 


Alignment 


The following terms describe some of the functions of the 
linker. For definitions of segment, group, and class, see 
Chapter 1, “Basic Information,” in this section. 


Alignment refers to certain segment boundaries. These 
can be byte, word, or paragraph boundaries. You specify 
the alignment in an assembly-language program. 


By specifying byte alignment, you tell the linker it may start 
a segment on any byte boundary (one segment may im- 
mediately follow another). Word alignment tells the linker 
to start segments only on even addresses. Paragraph align- 
ment tells it to start segments only on 16-byte boundaries. 


Combine Type 


A combine type is an attribute of a segment. It tells the 
linker how to combine segments that have the same name 
or it relays other information about the properties of a 
segment. Combine types are: stack, public, private, and 
common (see “How the Linker Combines and Arranges 
Segments’). 
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Canonical Frame 


The canonical frame of a group of segments is the starting 
address of the first segment in the group. Offsets are 
calculated from this address. 


How the Linker Combines and 
Arranges Segments 


The linker works with four combine types, which are 
declared in the source module for the assembler or com- 
piler: private, public, stack, and common. The memory 
combine type available in Microsoft’s Macro Assembler is 
synonymous with the public combine type. The linker 
does not automatically place memory combine type as the 
highest segments (as defined in the Intel standard). 


The linker arranges these combine types as follows: 


Private 


Private segments are loaded separ- 
ately and remain separate. They 
may be physically (but not logical- 
ly) contiguous, even if the seg- 
ments have the same name. Each 
private segment has its own canon- 
ical frame. 
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Public and Stack 


Public and stack segments of the 

same name and class name are 
loaded contiguously. Offset is from 

the beginning of the first segment 
loaded through the last segment 
loaded. There is only one canoni- 
cal frame for all public segments of 
the same name and class name. 
Stack and memory combine types 
are treated the same as public. 
However, the stack pointer is set to 
the last address of the first stack 
segment. 


Common 


Common segments of the same 
name and class name are loaded 
overlapping one another. There is 
IN only one canonical frame for all 
common segments of the same 
name. The length of the common 
area is the length of the longest 
segment. 
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Placing segments in a group in the assembler provides 
offset addressing of items from a single canonical frame 
for all segments in that group. 


DS:DGROUP XXXX0H 0 — relative offset 


Any number of other 
segments may 
intervene between 
segments of a group. 
Thus, the offset of ZOO from the 

ZOO may be greater beginning of the first 
than the size of segment (Segment A 
segments in the group here). 

combined, but no 

larger than 64K. 


An operand of 
DGROUP:ZOO in 
assembly language 
returns the offset of 


Segments are partitioned by declared class names. The 
linker loads all the segments belonging to the first class 
name encountered, then loads all the segments of the next 
class name encountered, and so on until all classes are 
loaded. 


If your program contains: 


SEGMENT ‘ZOO’ 
SEGMENT ‘BAZ’ 
SEGMENT ‘BAZ’ 
SEGMENT ‘NEW’ 
SEGMENT ‘ZOO’ 


mOoQOWDY> 


Linker loads the segments as: 
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If you are writing assembly-language programs, you can 
control the order of classes in memory by writing a dum- 
my module and listing it first after the linker’s Object 
Modules: prompt. The dummy module declares segments 
into classes in the order you want the classes loaded. 


Warning: Do not use this method with BASIC, COBOL, 
FORTRAN, or Pascal programs. Allow the compiler and the 
linker to perform their tasks in the normal way. 


Example: 


SEGMENT ‘CODE’ 

ENDS 

SEGMENT ‘CONST’ 

ENDS 

SEGMENT ‘DATA’ 

ENDS 

SEGMENT STACK = ‘STACK’ 
ENDS 

SEGMENT ‘MEMORY’ 

ENDS 


Make sure you declare all classes to be used in your 
program in this module. If you do not, you lose absolute 
control over the ordering of classes. 


mmovggwnaDy y> 


Also, if you want memory combine type to be loaded as the 
last segments of your program, you can use this method. 
Simply add MEMORY between SEGMENT and ‘MEMORY’ 
in the E segment line above. Note, however, that these 
segments are loaded last only because you imposed this 
control on them, not because of any inherent capability in 
the linker or assembler operations. 


Segment Addresses 


The 80186 must be able to address all segments in mem- 
ory. Any 20-bit number can be addressed. The 80186 
represents these numbers as two 16-bit numbers (for 
example, hex F:12). The F is a canonical frame address and 
the 12 is the offset. 
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The canonical frame address is the largest frame address 
or segment address that can contain the segment. An offset 
is the segment’s location, offset from the beginning of the a 
canonical frame. 


The linker recognizes a segment by its canonical frame 
address and its offset within the frame. 


To convert the address F:12 to a 20-bit number, shift the 
frame address left 4 bits and add the offset. Using the 
above example: 


FO 
te 12 


F:12 = 102 (20-bit address) 


How the Linker Assigns Addresses 


To assign addresses to segments, the linker orders each on™ 
segment by segment and class name. On the basis of the 
alignment and size of each segment (assuming the seg- 
ments are contiguous), the linker assigns a frame address 
and an offset to each segment. This information is used for 
resolving relocatable references. The addresses start at 
0:0. 


dl 


Relocation Fixups 


The linker performs relocation fixups (or resolves) on 
four types of references in object modules: 


* Short 

* Near self-relative 

¢ Near segment-relative 
* Long 


These references and the linker’s fixups are described in 
the next sections. 


J 
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Short References 


Short references are all self-relative. The implication is 
that the frame address of the target and source frames are 
the same. The linker generates the fixup error message 


Fixup offset exceeds field width 
under either of the following conditions: 
¢ The target and source frame addresses are different 


* The target is more than 128 bytes before or after the 
source frame address 


The resulting value of the short reference must fit into one 
signed byte. 


Near Self-Relative References 


When near self-relative references are used, the frame 
address of the target and source frames are the same. The 
linker generates the fixup error message under either of 
the following conditions: 


* The target and source frame addresses are different 


* The target is more than 32K before or after the source 
frame address 


The resulting value of the near self-relative reference must 
fit into one signed word (16 bits). 


Near Segment-Relative References 


Given the target's canonical frame, another frame is speci- 
fied (viaan ASSUME directive or the : operator in assembly 
language or via a high-level language convention). The 
target must be addressable through the canonical frame 
specified. The linker generates the fixup error message 
under either of the following conditions: 


* The offset of the target within the specified frame is 
greater than 64K or less than zero 


¢ The beginning of the canonical frame of the target is not 
addressable by the specified frame 
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The resulting value of a near segment-relative reference 
must be an unsigned word (16 bits). 


Long References 


Long references have a target and another frame (speci- 
fied by an ASSUME or bya high-level language). The target 
must be addressable through the canonical frame speci- 
fied. The linker generates the fixup error message under 
either of the following conditions: 


* The offset of the target within the specified frame is 
greater than 64K or less than zero 


* The beginning of the canonical frame of the target is not 
addressable by the specified frame. 


The resulting value of a long reference must be a frame 
address and an offset. 
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Linker Error Messages 


All messages, except for the warning messages, cause the 
link session to end. After you locate and correcta problem, 
you must restart the linker. 

Messages appear in the list file and are displayed, unless 
you direct the list file to CON. If you direct the file to CON, 
the error messages are suppressed. 


ATTEMPT TO ACCESS DATA OUTSIDE OF 
SEGMENT BOUNDS, POSSIBLY BAD OBJECT 
MODULE 

This usually indicates that a bad object file exists. 

BAD NUMERIC PARAMETER 

A numeric value is not given as digits. 

CANNOT OPEN TEMPORARY FILE 

The linker cannot create the file VM.TMP because the disk 


directory is full. Insert a new disk. Do not remove the disk 
that is to receive the List.map file. 


ERROR: DUP RECORD TOO COMPLEX 


A DUP record in an assembly-language module is too 
complex. Simplify the DUP record. 

ERROR: FIXUP OFFSET EXCEEDS FIELD WIDTH 
An assembly-language instruction refers to an address 


with a short instruction instead of a long instruction. Edit 
the assembly-language source and reassemble. 


INPUT FILE READ ERROR 
This usually indicates that a bad object file exists. 
INVALID OBJECT MODULE 


An object module or modules are incorrectly formed or 
incomplete (as when assembly is stopped in the middle). 


SYMBOL DEFINED MORE THAN ONCE 


Section IV / The Linker 


The linker found two or more modules that define one 
symbol name. 


PROGRAM SIZE OR NUMBER OF SEGMENTS 
EXCEEDS CAPACITY OF LINKER 


The total size may not exceed 384K bytes, and the number 
of segments may not exceed 255. 


REQUESTED STACK SIZE EXCEEDS 64K 


Specify a size less than or equal to 64K bytes with the 
/STACK switch. 


SEGMENT SIZE EXCEEDS 64k 
The addressing system limit is 64K bytes. 
SYMBOL TABLE CAPACITY EXCEEDED 


The number or length of the names caused them to ex- 
ceed the limit of approximately 25K bytes. 


TOO MANY EXTERNAL SYMBOLS IN ONE 
MODULE 


The limit is 256 external symbols per module. 

TOO MANY GROUPS 

The limit is 10 groups. 

TOO MANY LIBRARIES SPECIFIED 

The limit is eight libraries. 

TOO MANY PUBLIC SYMBOLS 

The limit is 1024 public symbols. 

TOO MANY SEGMENTS OR CLASSES 

The limit is 256 (segments and classes taken together). 


UNRESOLVED EXTERNALS: list 


i) 
iS) 
ON 
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The external symbols listed have no defining module 
among the modules or library files specified. 


VM READ ERROR 
This is a disk error; it is not caused by the linker. 
WARNING: NO STACK SEGMENT 


None of the object modules specified contains a statement 
allocating stack space, but you typed the /STACK switch. 


WARNING: SEGMENT OF ABSOLUTE OR 
UNKNOWN TYPE 


Abad object module exists or an attempt has been made to 
link modules that the linker cannot handle (for example, 
an absolute object module). 


No disk space remains in which to expand the VM.TMP file. 
WRITE ERROR ON RUN FILE 


This usually indicates there is not enough disk space for 
the run file. 


N 
NO 
NI 


-_~ 


Section V 
DEBUG 


The DEBUG program provides a controlled environment 
in which to test your executable object files. You can use 
DEBUG to alter the contents of a file or register, and then 
immediately execute the program to see if the changes are 
valid. You need not reassemble the program. 


How to Start DEBUG 


To start DEBUG, type 
DEBUG [pathname] [parameters] 


pathname specifies the program file to be loaded into 
memory. DEBUG loads the file, starting at 100H in the 
lowest available segment. The BX:CX registers are loaded 
with the number of bytes placed into memory. 


If you omit the pathname (you type only DEBUG (ENTER)) 
you can work with the current register contents. To load 
a file into memory, you must use the Name and Load 
commands. 


parameters is a list of pathname parameters and switches 
that are to be passed to the program when it is loaded. 
You may include parameters only if you included the 
pathname. 


DEBUG displays a hyphen (-) to indicate that it is ready to 
accept a command. 


Note: When DEBUG is started, it sets up a program seg- 
ment prefix (PSP) at Offset 0 in the program work area. If 
you don’t specify a pathname when you start DEBUG, you 
can overwrite the default PSP. If you are debugging a .com 
or .exe file, however, do not tamper with the PSP below 
relative address 5CH. If you do, DEBUG terminates. 
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When you start DEBUG, the segment registers (CS, DS, ES, 
and SS) are set to the bottom of free memory, and the 
instruction pointer (IP) is set to 0100H. All flags are 
cleared, and the remaining registers are set to zero. 


Do not restart a program after DEBUG displays the mes- 
sage “Program terminated normally.” To reload the 
program, you must use the Name and Load commands. 
Otherwise, it does not run properly. 


Commands 


Each DEBUG command consists of one letter followed by 
one or more parameters. You can use any combination of 
upper-case and lower-case letters in commands and 
parameters. While using DEBUG, you can also use the 
control keys and the MS-DOS editing functions (described 
in Section I, Chapter 4). 


At any time, you can abort any DEBUG command by 


pressing CTRL) CC _). 


To stop the screen from scrolling, press (TRL) C$); to 
continue scrolling, press (SPACEBAR). 


If a syntax error occurs in a DEBUG command, DEBUG 
displays the command line with the error indicated by an 
up-arrow (/\) and the word “error.” Example: 


D CS:g00 CS:110 
/\ Error 
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The following table summarizes the DEBUG commands, 
each of which is described in detail later. 


Command Syntax 

Assemble A [address] 

Compare C range address 

Dump D [range] 

Enter E address [list] 

Fill F range list 

Go G[ =address1 [address2 ...]] 

Hex H value! value2 

Input I portaddress 

Load L [address (drive sector sectorcount]| 
Move M range address 

Name N filespec1[filespec2 | 

Output O portaddress byte 

Quit Q 

Register R [registername] 

Search S range list 

Trace Tl =address|[value] 

Unassemble U [range] 

Write W [address [drive sector sectorcount]] 
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Command Parameters 


Parameters 


All DEBUG commands except Quit accept parameters. 
You may separate parameters with spaces or commas, but 
this is required only between two consecutive hexadeci- 
mal values. Thus, the following commands are the same. 


DCS:100 110 
D CS:100 110 
D,CS:100,110 


address 
A 1- or 2-part designation in one of the following formats: 


* Analphabetic segment register designation and an offset 
value. Example: 


CS:0100 
* A segment address and an offset value. Example: 
04BA:0100 


* An offset only, in which case the default segment is used. 
DS is the default segment for all commands except G, L, 
T, U, and W, for which the default segment is CS. 


All numeric values are hexadecimal. The colon is required 
to separate a segment designation and an offset. 


byte 


A 1- or 2-character hexadecimal value to be placed in or 
read from an address or register. 


drive 


A 1-digit value that indicates which drive the data is to be 
loaded from or written to. 


0 = Drive A 
1 = Drive B 
2 = Drive C 
3 = Drive D 
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filespec 


A file specification that consists of a drive specification, 
filename, and filename extension. (The three fields are 
optional, but at least the drive specification or filename 
should be specified. ) 


list 


A series of strings or byte values. list must be the last 
parameter on the command line. Example: 


CS:100 FF 42 “XXX” 1A 3 
portaddress 


A hexadecimal value of up to four characters, which speci- 
fies a port number. 


range 
A area of memory, specified by either of these formats: 
° address1 address2 

Example: 

CS:100 110 

address2 must be an offset value. 
° address L value 


value is the number of bytes on which the command is 
to operate. If you omit L va/ie, DEBUG assumes a value 
of 80 bytes. Do not use this format if another hex value 
follows the range. 


Example: 


CS:100 L 10 
CS:100 


The limit for the range is 10000 hex. To specify a value of 
10000 hex within four digits, enter 0000 (or 0). 


bo 
Ov 
Ov 
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registername 


See the explanation of the Register command for a list of 
valid register names. 


sector sectorcount 


1- to 3-character hexadecimal values that indicate the rela- 
tive sector number on the disk and the number of disk 
sectors to be written or loaded. 


The first sector of Track 0 on Head 0 is Sector 0. The 
remaining sectors of Head 0, Track 0 are numbered con- 
secutively. Numbering continues with the first sector of 
the Head 1 track that is of the same radius as Track 0. When 
all sectors on all heads of the track (that is of the same 
radius as Track 0) are numbered, numbering continues 
with the first sector of Head 0 of the next track. 


string 


Any number of characters enclosed in quotation marks. 
Quotation marks may be either single (() or double (>). 
The ASCH values of the characters in the string are used as 
a list of byte values. 

If quotation marks are to be used within a string, they must 
be either the opposite set or they must be doubled. 


Examples of the correct uses of quotation marks: 


‘This “string” is correct.’ 
‘This ° ‘string’ ” is correct.’ 
“This ‘string’ is correct.” 
“This “ “string” ” is correct.” 


Examples of incorrect uses of quotation marks: 


‘This ‘string’ is not correct. 
“This “string” is not correct.” 


value 


A hexadecimal value of up to four characters. 


i) 
On 
+ 


Assemble 


A [address] 


Assembles Macro Assembler statements directly into 
memory. 


address is the starting address at which you want the 
instructions you enter to be assembled in memory. 


If vou omit the address, the Assemble command uses the 
address that follows the last instruction assembled by a 
previous Assemble command. If no Assemble statement 
was used previously, assembly starts at CS:0100. All 
numeric values are hexadecimal and can be entered as 
one to four characters, 


If a statement contains a syntax error, DEBUG displavs 
* Error 
and redisplavs the current assembly address. 


The segment override mnemonics are CS:, DS:, ES:, and 
SS:. The mnemonic for the far return is RETF. String 
manipulation mnemonics must explicitly state the string 
size. For example, use MOVSW to move word strings and 
MOVSB to move byte strings. 


Prefix mnemonics must be specified in front of the 
opcode to which they refer. 


The assembler automatically assembles short, near, or far 
jumps and calls, depending on byte displacement to the 
destination address. These may be overridden with the 
NEAR or FAR prefix. Examples: 


0100:0500 JMP 502 ; a 2-byte short jump 
0100:0502 JMP NEAR 505 ; a3-byte near jump 
0100:0505 JMP FAR’ 50A_ ; a 5-byte far jump 


The NEAR prefix may be abbreviated to NE. 
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DEBUG cannot tell whether some operands refer to a 

word memory location or to a byte memory location. In 

such a case, the data type must be explicitly stated with the oo 
prefix “WORD PTR” or “BYTE PTR”. These can be abbrevi-  ~. 
ated “WO” and “BY”. Example: 


NEG BYTE PTR [128] 
DEC WO [SI] 


DEBUG also cannot tell whether an operand refers to a 
memory location or to an immediate operand. DEBUG 
uses the convention that operands enclosed in square 
brackets refer to memory. Example: 


MOV AX,21 ; Load AX with 21H 
MOV AXj21] ; Load AX with the contents of 
; memory location 21H 


Two popular pseudo-instructions are available with the 
Assemble command. The DB opcode assembles byte 

values directly into memory. The DW opcode assembles (~~ 
word values directly into memory. Example: 


DB 1,2,3,4,“THIS IS AN EXAMPLE” 

DB ‘THIS IS A QUOTE: ”’ 

DB “THIS IS A QUOTE: ’” 

DW 1000,2000,3000,“BACH” 

All forms of register indirect commands are supported. 
Example: 

ADD BX,34[BP + 2].[SI-1] 

POP [BP + DI] 

PUSH [S!] 

All opcode synonyms are also supported. Example: 

LOOPZ 100 

LOOPE 100 

JA 100 eo 
JNBE 100 -" 
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For 8087 opcodes, the WAIT or FWAIT must be explicitly 
specified. Example: 


FWAIT FADD ST,ST(3)_; This line will assemble an 
; FWAIT prefix 
FLD TBYTE PTR [BX] _ ; This line will not 


i) 
Or 
~N 


Compare 


C range address 


Example: 


Compares the portion of memory specified by the range 
to a portion of the same size beginning at the specified 
address. 


If the two areas of memory are different, DEBUG displays 
the differences in this format: 


address1 byte1 byte2 address2 


address1 byte! refers to the address and contents of a 
location in the specified range. 


byte2 address2 refers to the corresponding address and 
contents in the block starting at address. 


If the two areas of memory are identical, DEBUG simply 
returns with the prompt. 


If you enter only an offset for the starting address of range, 
the segment indicated by Register DS is used. 


The following commands have the same effect: 
C 100,1FF 300 (ENTER 
C 100L100 300 (ENTER 


Each command compares the block of memory from 
DS:100 to DS:1FF with the block of memory from DS:300 
to DS:3FF. 
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Dump 
D [address] 


D [range] 

Displays the contents of the specified address or range in 

memory. 

The dump is displayed in two portions: 

* A hexadecimal portion. Each byte is displayed in hex- 
adecimal. 

¢ An ASCII portion. Each byte is displayed as an ASCII 
character. Characters that cannot be displayed are 
shown as a period (.). 

Each displayed line begins on a 16-byte boundary and 

shows 16 bytes. A hyphen appears between the eighth and 

ninth bytes. 

If you type the D command and specify only a starting 

address, the contents of memory are displayed starting at 

the address. 

If you enter the D command with neither parameter, 128 

bytes are displayed at the first address after the last address 

displayed by a previous D command. 

If you enter only an offset for the starting address, the 

segment indicated by register DS is used. 

Example: 


D CS:100 109 (ENTER 


DEBUG displays the contents of the range C:100 109 in the 
following format: 


04BA:0100 54 4F 4D 20 53 41 57 59 45 52 TOM 
SAWYER 
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Enter 


E address [ list| 


Enters byte values into memory at the specified address. 


If you type the optional /ist of values, DEBUG automatically 
replaces the contents of memory beginning at address 
with the new values. Example: 


E DS:100 45 Al “abc” OF 


DEBUG places the six bytes in the list into memory begin- 
ning at DS:100. 


If you omit the “ist, DEBUG displays the address and its 
contents and then waits for your input. You can do any of 
the following: 


Enter a hexadecimal byte value to replace the displayed 
value. (Illegal or extra characters are ignored.) 


Press to advance to the next byte. To change 
this value, simply type the new value as described above. 
Each press of advances to the next byte with- 
out changing the current byte. 


If you space beyond an 8-byte boundary, DEBUG starts a 
new display line. 


Press (~) to back up to the preceding byte. The preced- 
ing address and its contents are displayed on the next 
line. If you want to change this byte, simply type the new 
value as described above. Each press of G) backs up 
one more byte without changing the current byte. 


Press (ENTER) to end the Enter command. 


If you enter only an offset for the address, the segment 
indicated by register DS is used. 
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E CS:1004 


causes DEBUG to enter byte values into memory begin- 
ning at DS:100. DEBUG displays the address and its con- 
tents (EB) as shown here. (The underscore (_~) represents 
the cursor.) 


04BA:0100 EB. - 


To change the value from EB to 41, type 41 (at the present 
cursor position) and press (SPACEBAR). DEBUG stores the 
value 41 and displays the contents of the next byte: 


04BA:0100 EB.41 10. - 


To display the contents of the next two bytes, press 


twice more. You might see: 

04BA:0100 EB.41 10. 00. BC... 
To change BC to 42, type 42 as shown: 

04BA:0100 EB.41 10. 00. BC.42 - 


If you want to go back and change 10 to 6F, press (-) twice 
to return to value 10, and then type OF: 


04BA:0100 EB.41 10. 00. BC.42- 
04BA:0102 00.- 
04BA:0101 10.6F. 


Press (ENTER) to end the Enter command. 


Fill 
F range list 


Example: 


Fills the memory locations in the specified range with the 
values in the /ist. 


If the /ést contains fewer bytes than the range, DEBUG uses 
the /ist until all locations in the range are filled. 


If the /ist contains more bytes than the range, DEBUG 
ignores the extra values in the Jist. 


If you enter only an offset for the starting address of the 
range, DEBUG uses the segment indicated by Register DS. 


F 04BA:100 L 100 42 45 52 54 41 


causes DEBUG to fill memory locations 04BA:100 through 
O4BA:1FF with the bytes specified. The five values are 
repeated until all 100H bytes are filled. 
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Go 


G|[ =address1[ address2 ... |] 


Executes the program currently in memory. Stops execu- 
tion at specified breakpoints and displays the registers, 
flags, and instruction line for the next instruction to be 
executed. 


If you include address1, execution begins at address1 in 
the CS segment. The equal sign (=) is required. 


If you don’t include an address, the program executes 
starting with the current instruction. The address of the 
current instruction is determined from the contents of the 
CS and IP registers. 


You can use the other optional addresses to set break- 
points. These allow you to examine the register contents 
and flag settings in effect when a specified address is 
reached during program execution. 


You can list up to 10 addresses in any order. If you enter 
only an offset for a breakpoint address, the segment indi- 
cated by register CS is used. Breakpoints may be set only at 
addresses that contain the first byte of an 80186 opcode. 
Execution stops when any breakpoint is reached. 


The user stack pointer must be valid and have 6 bytes 
available for the Go command. This command uses an 
IRET instruction to cause a jump to the program under 
test. The user stack pointer is set and the user flags, CS 
register, and Instruction Pointer are pushed on the user 
stack. 


An interrupt code (OCCH) is placed at the specified break- 
point address(es). When an instruction with the break- 
point code is reached, DEBUG restores all breakpoint 
addresses to their original instructions. If no breakpoint is 
reached, the original instructions are not restored. 


243 


Section V / DEBUG 


Example: 


G CS:7550 


causes the program currently in memory to execute up to 
address 7550 in the CS segment. DEBUG restores the 
original instructions, displays the register contents and the 
flags, and the Go command ends. 


After execution halts at a breakpoint, you can enter the Go 
command again. The program resumes execution at the 
instruction after the breakpoint. 
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Hex 


H valuel value2 


Performs hexadecimal arithmetic on valued and value2. 


DEBUG first adds valiteZ and valiue2, and then subtracts 
value2 from value1. The sum and difference are displayed 
on one line. 


Example: 
H 19F 10A 


causes DEBUG performs the arithmetic and displays the 
results: 


02A9 0095 


The sum of 19F and 10A is 02A9 and the difference is 0095. 


Input 
I portaddress 


Inputs and displays one byte from the specified port. 


A 16-bit port address is allowed. The displayed byte is in 
hexadecimal. 


Example: 
Suppose you type the following command: 
| 2F8 (ENTER 


causes DEBUG to input the byte at Port 2F8 and display it. 
If the byte is 42, DEBUG displays: 


42 
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Load 


L [address[ drive sector sectorcount]| 


Loads a file into memory. 


Before you use the Load command to load a file, the file 
must have been named either when DEBUG was started or 
with the Name command. Both procedures format a file- 
spec properly in the File Control Block at CS:5C. 


If you enter the L command without any parameters, 
DEBUG loads the file into memory beginning at address 
CS:100 and sets BX:CX to the number of bytes loaded. If 
you enter the L command and specify address, DEBUG 
loads the file beginning at the specified address in mem- 
ory. In both cases, the file is read from the drive specified 
in the filespec, or from the default drive if no drive was 
specified. 


If you enter the L command with all parameters specified, 
absolute disk sectors are loaded. The sectors are loaded 
from the specified drive (0 = Drive A,1 = Drive B, and so 
on.). DEBUG begins loading with the specified sector and 
continues until the number of sectors indicated by sector- 
count have been loaded. 


If you enter only an offset for the starting address, the 
segment indicated by register CS is used. 


If you load a file which has an .EXE extension, DEBUG 
relocates the file to the load address specified in the 
header of the .EXE file, and ignores any address you may 
have specified with the L command. The header itself is 
stripped of the .EXE file before it is loaded into memory. 
Thus the size of an .EXE file on disk differs from its size in 
memory. 


If the file you name with the Name command or specify 
when DEBUG is started is a HEX file, then typing the L 
command with no parameters causes DEBUG to load the 
file beginning at the address specified in the .HEX file. If 
the L command includes the address option, DEBUG adds 
the specified address to the address found in the .HEX file 
to determine the start address for loading the file. 


247 


Section V / DEBUG 


Example: 


Suppose you type the following commands: 


DEBUG 
N FILE.COM 
L 


DEBUG loads the file called FILE.;COM from the default 
disk. 


To load only portions of a file or certain sectors from a 
disk, type a command similar to the following: 


L 04BA:100 2 OF 6D 


DEBUG loads 6DH (109) consecutive sectors into mem- 
ory from Drive C, beginning with absolute sector number 
OF (15). The data is placed beginning at address 
04BA:0100. 
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Move 


M range address 


Example: 


Moves the block of memory specified by range to the 
location beginning at address. 


Overlapping moves, where some locations in the range 
are also in the block beginning at address, are always 
performed without loss of data during the transfer. The 
addresses in the range remain unchanged unless new data 
is written to them by the move. 


If you enter only an offset for the starting address of the 
range or for the address, the segment indicated by register 
DS is used. If you specify an ending address for the range, 
enter only an offset value. 


M CS:100 110 CS:500 


causes DEBUG to move the data that is between CS:100 
and CS:110 to the memory area beginning at CS:500. 


Name 


N filespec! [filespec2 ... | 


Assigns a filespec for a later Load or Write command. If you 
start DEBUG without naming any file to be debugged, then 
you must enter the N filespec command before a file can 
be loaded. The Name command also assigns filespec 
parameters to the file being debugged. 


Four areas of memory can be affected by the Name 
command: 


DS:5C File Control Block for file 1 
DS:6C File Control Block for file 2 
DS:80 Count of characters 
DS:81 All characters typed 


A File Control Block (FCB) for the first filespec parameter 
given to the Name command is set up at DS:5C. If you 
include filespec2, an FCB is set up for it at DS:6C. DS:80 
contains the number of characters typed after the letter N 
in the Name command line. All characters typed after the N 
are stored beginning at DS:81. 
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N file1.exe (ENTER 


L 
N file2.dat file3.dat 
G 


In the above sequence of commands, the Name command 
sets Filel.exe as the filespec for the Load command that 
follows. After Filel.exe is loaded into memory, the Name 
command is used again, this time to specify the param- 
eters to be used by Filel.exe. When the Go command is 
executed, Filel.exe is executed as if Filel File2.dat 
File3.dat had been entered at the MS-DOS command level. 


DEBUG prog.com 
N param1 param2/C (ENTER 
G 


In the above example, the Go command executes the file 
in memory as if PROG param] param2/C had been typed at 
the MS-DOS command level. 
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Output 
O portaddress byte 


Sends the byte to the specified portaddress. 
A 16-bit port address is allowed. 
Example: 
O 2F8 4F 
causes DEBUG to output the byte value 4F to Port 2F8. 
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Quit 


Example: 


Ends the DEBUG program. 


The Quit command exits DEBUG without saving the file 
you are debugging, and returns to the MS-DOS command 
level. 


Q (ENTER 
ends DEBUG and returns to the MS-DOS system prompt. 


253 


Register 


R [registername]| 


Performs three functions: 
* Displays the contents of all registers and the flag settings 


* Displays the contents of a single register and lets you 
change the contents 


* Displays the flag settings and lets you change the settings 


If you enter R with no registername, DEBUG displays the 
contents of all registers and flags, together with the next 
instruction to be executed. 


If you include a register name, DEBUG displays the 16-bit 
value of that register in hexadecimal, and then displays a 
colon prompt. You then either change the contents of the 
register by entering a 1- to 4-character hexadecimal value, 
or leave the contents unchanged by pressing (ENTER). The 
valid registernames are: 


AX BP SS 
BX SI CS 
CX DI IP 
DX DS PC 
SP ES F 


Both IP and PC refer to the Instruction Pointer. 


If you enter F as the registername, DEBUG displays a 
two-letter status code for each flag, showing whether it is 
set or clear. To change any flag, enter the opposite code. 
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The flags are listed below with their codes for set and 
clear: 


Flag Name Set Clear 
Overflow (yes/no) OV NV 
Direction 

(decrement/increment) DN UP 
Interrupt 

(enable/disable) EI DI 
Sign 

(negative/positive) NG PL 
Zero (yes/no) ZR NZ 
Auxiliary carry 

(yes/no) AC NA 
Parity (even/odd) PE PO 
Carry (yes/no) CY NC 


Whenever you enter the RF command, DEBUG displays 
the flags in the order shown above at the beginning of a 
line. The hyphen prompt (-) appears at the end of the line. 
Now you can change any of the flag values by typing 
alphabetic pairs, in any order. You need not leave spaces 
between the flag entries. To exit the R command, press 
(ENTER); the changes are made. Flags for which you did not 
type a new value remain unchanged. 
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Examples: 


Type 
R (ENTER 


DEBUG displays all registers, flags, and the next instruc- 
tion to be executed. For example, if the location is CS:11A, 
the display looks similar to this: 


AX =0E00 BX=00FF CX=0007 DX=01FF 
SP =039D BP =0000 

S!|=005C DI=0000 DS=04BA ES=04BA 
SS =04BA CS=04BA 

IP =011A NV UP DI NG NZ AC PE NC 

Q4BA:011A CD21 INT 21 


If you type 

RF 

DEBUG displays the flags 

NV UP DI NG NZ AC PE NC -- 


Type one or more flag designations, in any order, with or 
without intervening spaces. Example: 


NV UP DI NG NZ AC PE NC - PLEICY(ENTER) 
DEBUG makes the requested changes. 

If you type 

R AX 

DEBUG displays the contents of the single register AX: 
AX 0E00 


To change the contents to OOFF, simply enter FF after the 
colon prompt. 
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Search 
S range list 


Searches the locations in the range for the /ist of bytes. 


The /ist may contain one or more bytes, each separated by 
a space or comma. DEBUG displays the starting address 
for each match found. 


If no addresses are displayed, the /ést was not found. 


If you enter only an offset for the starting address of range, 
the segment indicated by register DS is used. 


Example: 
S CS:100 110 41 


causes DEBUG to search the addresses from CS:100 to 
CS:110 for 41H. If two matches are found, DEBUG displays 
a response similar to this: 


04BA:0104 
04BA:010D 


Trace 


T| =address|| value] 


Examples: 


Executes one or more instructions, displaying the register 
contents, flags, and next instruction after each instruction 
executes. 


If you enter T with no parameters, DEBUG executes the 
instruction at CS:IP (the current instruction) and displays 
the registers and flags. If you enter the optional = address, 
tracing begins at the specified address. The optional value 
causes DEBUG to execute and trace the number of instruc- 
tions specified by value. 


When tracing more than one instruction, remember that 
you can suspend the display by pressing C$) in 
order to study the registers and flags for any instruction. 
Press any other key to continue scrolling. 


T (ENTER 


causes DEBUG to display the registers and flags for the 
current instruction. If the current instruction is 
04BA:011A, DEBUG might display: 


AX=0E00 BX=00FF CX=0007 DX=01FF 
SP =039D BP = 0000 
SI=005C DI=0000 DS=04BA ES=04BA SS=0 
4BA CS=04BA 
IP =011A NV UP DI NG NZ AC PE NC 
Q4BA:011A CD21 INT 21 


If you type 
T=011A 10 (ENTER 


DEBUG executes 16 (10 hex) instructions beginning at 
011A in the current segment and displays the registers and 
flags after each instruction. 


iS) 
NN 
ice) 


aX 


Unassemble 


U [address] 
U [range] 


Disassembles instructions and displays their addresses, 
their hexadecimal values, and the source statements that 
correspond to them. 


The display of disassembled code looks like a listing for an 
assembly-language source file. If you enter the U com- 
mand without parameters, 32 bytes are disassembled at 
the first address following the last instruction disassem- 
bled by the previous Unassemble command. If you specify 
address, instructions are disassembled beginning with 
address. 


If you enter the U command with range specified, DEBUG 
disassembles all bytes in the range. 


In all cases, DEBUG may disassemble and display slightly 
more bytes than the default amount or the number you 
requested. This is because instructions are of varying 
lengths, and the last instruction disassembled may include 
more bytes than expected. 


If you enter only an offset for the starting address, the 
segment indicated by register CS is used. 


If you have altered some locations using DEBUG, you can 
enter the U command for the changed locations, view the 
new instructions, and use the disassembled code to edit 
the source file. 
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Example: 


U04BA:100 L10 


causes DEBUG to disassemble 16 bytes beginning at 
address 04BA:0100 and displays information similar to the 


following: 


04BA:0100 
04BA:0103 
04BA:0104 
04BA:0106 
04BA:0109 
04BA:010A 
04BA:010B 
04BA:010C 
04BA:010D 
04BA:010E 
04BA:010F 


206472 AND [SI+72],AH 


69 DB 69 

7665 JBE 016B 

207370 AND [BP+DI+70],DH 
65 DB 65 

63 DB 63 

69 DB 69 

66 DB 66 

69 DB 69 

63 DB 63 

61 DB 41 
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Write 


W [address| drive sector sectorcount]] 


Writes the data being debugged to a disk file. 


If you enter the W command with no parameters, the file is 
written beginning from CS:100. If you enter it with only 
the address parameter, the W command writes the file 
beginning at that address. In either case, you must be 
certain that BX:CX contains the number of bytes to write. 
This value may have been set correctly by the DEBUG or 
Load commands, but a Go or Trace command may have 
altered it. (Note that if you load and modify a file, the 
name, length, and starting address are already set correctly 
to save the modified file as long as the length has not 
changed.) 


The file must have been named either with the DEBUG 
startup command or with the Name command. Both com- 
mands format a filespec properly in the File Control Block 
at CS:5C. DEBUG writes the file to the drive specified in 
the filespec or to the default drive if none is specified. 


If you specify all parameters in the Write command, the 
write begins from the memory address specified. The file 
is written to the specified drive (0 = Drive A, 1 = Drive B, 
and so on). DEBUG writes the file beginning at the sector 
specified by sector, until the number of sectors specified 
by sectorcount have been written. 


If you enter only an offset for the starting address, the 
segment indicated by register CS is used. 


Ifa disk write error occurs, DEBUG displays a message. To 
try the write operation again, press (F3) to redisplay the 
Write command, and then press (ENTER). 


Note: Be very careful when you write to absolute sectors 
on the disk. Data which was previously in these sectors is 
destroyed. 
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W CS:100 1 37 2B 


writes the contents of memory to the disk in Drive B, 
beginning with memory address CS:100. The data is writ- 
ten beginning at relative sector 37H and consists of 2BH 
sectors. The DEBUG prompt is displayed when the write is 
complete. 
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Error Messages 


During a DEBUG session, you may receive any of the 
following error messages. Each error ends the DEBUG 
command under which it occurred, but does not end 
DEBUG itself. 


BF (Bad flag) 


You tried to alter a flag, but the characters entered were 
not one of the allowable pairs of flag values. See the 
explanation of the Register command for the list of valid 
flag entries. 


BP (Too many breakpoints) 


You specified more than ten breakpoints as parameters to 
the Go command. Retype the Go command again with ten 
or fewer breakpoints. 


BR (Bad register) 


You typed the Register command with an invalid register 
name. See the Register command for the list of valid 
register names. 


DF (Double flag) 


You entered two values for one flag when using the Regis- 
ter command. You may specify a flag value only once per 
RF command. 
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Appendix A 


Problems and Error Messages 


This appendix consists of two parts — the “Device Error 
Messages” and the “Command Error Messages.” 

Device errors are errors that occur while MS-DOS is writ- 
ing to a disk or another system device (such as a printer). 
All other errors, except those given by a special program 
(such as the linker), are MS-DOS or command errors. 


If your computer displays a message not listed in this 
appendix, the error may be from your application pro- 
gram. See your application program manual. 


Note: Error messages for the Linker, the Editor and DE- 
BUG are included in those sections of this manual. 


Device Error Messages 


If a device error occurs at any time during a command or 
program, MS-DOS returns an error message in either of 
the following formats: 


hype error while reading on drive drive 
Abort, gnore,Retry: 


gype error while writing on drive drive 
Abort, Ignore,Retry: 


drive is the drive in which the error occurred. 
dpe is one of the following error types: 
Bad call format 


The device driver was passed an incorrect length request 
header. Contact the dealer from whom you purchased the 
device driver. 


Bad command 


MS-DOS issued an invalid command for the device driver. 
Try the command again. If it continues to fail, contact the 
dealer from whom you bought the device driver. 
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Bad unit 


A device driver passed an invalid sub-unit number. Con- 
tact the dealer from whom you purchased the device 
driver. 


Data 


The data cannot be read or written correctly. You probably 
have a flawed disk. 


Disk 

The error is of a type other than those listed above. 
No paper 

The printer is out of paper. 

Non-DOS disk 

The disk is not in a format recognizable by MS-DOS. 
Not ready 


The device is not ready. Check to see that the drive latches 
are closed and that all devices are on and ready. 


Read fault 


The device cannot successfully read the data. You may 
have a flawed disk. Try to copy all files to another disk. If 
this fails, you probably have a hardware problem. Contact 
your dealer. 


Sector not found 


MS-DOS is requesting a sector number higher than the 
highest number on the disk. 


Seek 


The disk drive or hard disk cannot locate the proper track 
on the disk. 
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Write fault 


The device cannot successfully write the data. You may 
have a flawed disk. Try to copy all files to another disk. If 
this fails, you probably have a hardware problem. Contact 
your dealer. 


Write protect 


You tried to write to a write-protected diskette. Remove 
the write-protect tab, then try again. 


After displaying a device error message, MS-DOS 
waits for you to enter one of the following 
responses: 


A Abort. Terminate the program requesting the disk 
read or write. 


I Ignore. Ignore the bad sector and pretend the error 
did not occur. 


R___ Retry. Repeat the operation. Use this response only 
after correcting the error (such as a Not Ready or 
Write Protect error). 


Attempt recovery by entering responses in this order: 


1. R (to try again) 
2. A (to terminate the program and try a new disk) 


One other error message might be related to faulty disk 
read or write: 


File allocation table bad for drive drive 


This message means that the copy in memory of one of the 
allocation tables has pointers to nonexistent blocks. Pos- 
sibly the disk was incorrectly formatted or not formatted 
before use. If this error persists, the disk is currently 
unusable and must be formatted prior to use. 


MS-DOS and Command Errors 
A 


After format, one of system sectors could not be 
read 


FORMAT. The system sectors (boot, file allocation table, 
and directory) are required for the disk to be useful. 


All files canceled by operator 


PRINT. This is a reminder only. You used the /T parameter 
to cancel the printing of all files in the print queue. 


Allocation error, size adjusted 


CHKDSK. A filename is displayed with this message. The 
File Allocation Table (FAT) contains an invalid sector num- 
ber. CHKDSK automatically truncates the file at the end of 
the last valid sector number. 


B 
Bad command or filename 


Commands. The command is not valid. Check spellings 
and re-enter the command. If the command is an external 
command, make sure it is in the directory that MS-DOS is 
searching for commands. If you are trying to execute a 
batch file, make sure you are in the directory that contains 
that file. 

Bad switch syntax 


COMPDUPE. You used an invalid switch syntax (such as /S 
only) or a switch other than /D or /S. 


Cc 


Cannot CHDIR to filename 
Tree past this point not processed 


CHKDSK. This error is corrected automatically. 


Cannot CHDIR to root 
Processing cannot continue 
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CHKDSK. The disk you are checking is bad. Restart the 
system and try using RECOVER command. 


D 
Destination disk format error 


COMPDUPE. An error occurred during formatting. The 
disk may be flawed or you may have inserted it in the drive 
incorrectly. 


Destination disk read error 


COMPDUPE. If you are duplicating, this error causes MS- 
DOS to abort COMPDUPE and to return to the command 
ready prompt. If you are comparing, it changes the track 
status indicator to the appropriate character (S, F, D, or C) 
and does not display an error message. 


Destination disk write error 


COMPDUPE. If you are duplicating, this error causes MS- 
DOS to abort COMPDUPE and to return to the command 
ready prompt. If you are comparing, it changes the track 
status indicator to the appropriate character (S, F, D, or C) 
and does not display an error message. 


Disk error reading FAT 


CHKDSK. Use the COPY command to copy all files to 
another disk. 


Disk error writing FAT 


CHKDSK. Use the COPY command to copy all files to 
another disk. 


Disks do not compare 
COMPDUPE. 
Drive not ready 


PRINT. If this message occurs when PRINT attempts a disk 
access, PRINT keeps trying until the drive is ready. 


E 


Errors found, F parameter not specified 
Corrections will not be written to disk 


CHKDSK. Specify the /F switch to correct the errors. 
Error writing boot sector to destination 


FORMAT. All floppy disks — both data and system disks — 
must have a boot sector so that they may be used by the 
system. 


Errors writing to the system sectors, cannot 
continue 


FORMAT. The system sectors (boot, file allocation table, 
and directory) are required for the disk to be useful. 


F 


File canceled by operator 


PRINT. This is a reminder only. You used the /C parameter 
to cancel the current file in the print queue. 


File cannot be converted 


EXE2BIN. The source file is not in the correct format. CS:IP 
does not meet either criterion discussed in the EXE2BIN 
command. CS:IP meets the .com file criterion but has 
segment fixups. The file is not a valid executable file. 


File cannot be copied onto itself 
n File(s) copied 


COPY. You tried to copy a file to a file that has the same 
name. Either change the name of your copy, or put it in a 
different directory or on a different disk. 


File creation error 


Commands. You tried unsuccessfully to add a file to the 
directory. You either tried to exceed the limit of 110 files 
per directory or the directory does not contain enough 
space for the file. Run CHKDSK to determine if the direc- 
tory is full or if some other condition caused the error. 
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File not found 


MS-DOS and commands. The specified file does not exist 
in the specified directory or the current directory. Use the 
DIR command to see which directory the file is in. Also, 
check the spelling of the filename. 


filename is cross linked on cluster 


CHKDSK. This message names each of the two files in 
error. Copy both files then delete both cross-linked files 
(the original files). 


*** Files are different *** 
FC. No matches are found after the first mismatch. 


First cluster number is invalid 
entry truncated 


CHKDISK. This error is corrected automatically. 
Fixups needed - base segment (hex): 


EXE2BIN. The source (.exe) file contains information that 
indicates that a load segment is required for the file. 
Specify the absolute segment address at which the 
finished module is to be located. 


H 
Has invalid cluster, file truncated 


CHKDSK. The file contains an invalid pointer to the data 
area. CHKDSK corrects this error automatically by truncat- 
ing the file to the last valid data block. 


I 
Incompatible system size 


SYS. The system files IO.SYS and MSDOS.SYS do not take 
up the same amount of space on the target disk as the new 
system requires. 
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Insufficient memory 


Commands. There is not enough available memory to run 
the command. Copy some files to another disk and try 
again. 


Insufficient room in root directory 
Erase files in root and repeat CHKDSK 


CHKDSK. CHKDSK cannot process until you delete files in 
the root directory. 


Invalid current directory 
Processing cannot continue 


CHKDSK. Restart the system and re-run CHKDSK. 


Invalid date 
Enter new date: 


DATE. Enter a valid date, making sure you use hyphens (-) 
or slashes (/) to separate the parts of the date. 


Invalid drive specification 


Commands. Use a valid drive specification, making sure 
you include the colon (:). 


Invalid parameter 


Commands. You specified a parameter that does not exist. 
Check the command syntax in this manual. 


Invalid sub-directory entry 
CHKDSK. This error is corrected automatically. 
Invalid number of parameters 


Commands. Re-enter the command, including the correct 
number of parameters. 


Invalid time 
Enter new time: 


TIME. Check the command syntax and parameters in this 
manual. Then enter a valid time, making sure you use a 
colon (:) to separate hours, minutes, and seconds, and a 
period (.) to separate hundredths of a second. 


L 

Label not found 

GOTO. The specified label does not exist in the batch file. 
List output is not assigned to a device 


PRINT. The device specified as the PRINT output device is 
invalid. 


x lost clusters found in y chains 
Convert lost chains to files (Y/N)? 


CHKDSK. If you type Y (ENTER), CHKDSK creates a direc- 
tory entry and a file in which you can resolve this problem 
(files created by CHKDSK are named FILE2n2nnnnn). 
CHKDSK displays: X bytes disk space freed. Ifyou have not 
specified the /F switch, CHKDSK frees the clusters and 
displays: X bytes disk space would be freed. 

N 

No files match pathname 

PRINT. The files you tried to add to the queue do not exist. 
No room for system on destination disk 


SYS. If the target disk contains files you don’t need, use the 
ERASE command to delete as many as necessary to make 
room for the system. Otherwise, use a different disk as the 
target. 


P 
PRINT queue is empty 


PRINT. There are no files in the print queue. 
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PRINT queue is full 
PRINT. The queue can contain no more than 10 files. 


Probable non-DOS disk 
Continue (Y/N)? 


CHKDSK. You are not using an MS-DOS disk. Type Y 
ENTER) to continue processing or N (ENTER) to stop 


processing. 

Read error in pathname 

FC. FC could not read the entire file. 
S 

Source disk read error 


COMPDUPE. If you are duplicating, this error causes MS- 
DOS to abort COMPDUPE and to return to the command 
ready prompt. If you are comparing, it changes the track 
status indicator to the appropriate character (S, F, D, or C) 
and does not display an error message. 


Syntax error 

Commands. Re-enter the command, using the proper 
syntax, 

U 


Unrecoverable error in directory 
Convert directory to file (Y/N)? 


CHKDSK. If you type Y (ENTER), CHKDSK converts the bad 
directory into a file. You can then fix the directory or 
delete it. If you type N (ENTER), the directory becomes 
unusable, and you can neither fix nor delete it. You should 


always type Y (ENTER). 
Use HFORMAT to format hard disks 


FORMAT. You are trying to use the FORMAT command to 
format a hard disk. Use HFORMAT instead. 


Ww 
Warning-directory full 


RECOVER. The disk does not contain enough directory 
space to recover more files. Copy some files to another 
disk, then erase the originals. Run RECOVER again. 


WARNING -Read error on EXE file 
Amount read less than size in header 


EXE2BIN. This is a warning message only. 
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Command Quick Reference 


BACKUP 


BREAK 


CHDIR 
(CD) 


CHKDSK 


CLS 
COMPDUPE 


COPY 
CTTY 
DATE 


DEL 
(ERASE) 


DIR 
DISKCOPY 
ECHO 


ERASE 
(DEL) 
EXE2BIN 


EXIT 


FC 
FIND 


Copies information from hard disk to 
floppy disk (diskette) 


Sets the (CTRL) C€_) check 


Changes the current directory and dis- 
plays it (CD) ; 


Scans the directory of the current or 
specified drive and checks for 
consistency 


Clears the screen 


Copies the diskette in Drive A onto the 
diskette in Drive B and compares the 
diskettes 


Copies the specified file(s) 
Changes the input/output device 
Displays and sets the date 


Deletes the specified file(s) 


Lists the requested directory entries 
Copies a disk 


Turns the batch file echo feature on or 
off 


Deletes the specified file(s) 


Converts executable files to binary 
format 


Exits a command and returns to the low- 
er level 


Compares the contents of two files 


Searches for a constant string of text 
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Executes a command for each item in a 
set 


Formats a floppy disk to receive MS-DOS 
files 


Transfers control to a certain line in a 
batch file 


Allows conditional execution of com- 
mands in batch file processing 


Formats a hard disk to receive MS-DOS 
files 


Makes a directory 


Displays output one screen at a time 
Sets a command search path 
Suspends execution of a batch file 


Lets you print while processing other 
MS-DOS commands 


Sets a new system prompt 
Recovers a bad disk 
Displays a comment in a batch file 


Renames a file 


Copies backed up files from floppy disk 
to hard disk 


Removes a directory 


Sets one string value to another 


Increases the number of replaceable pa- 
rameters in a batch process 


Sorts data alphabetically, forward or 
backward 
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Transfers MS-DOS system files from 
Drive A to the drive specified 


Displays and sets the time 

Displays the contents of the specified file 
Prints the MS-DOS version number 
Verifies writes to disk 


Displays the volume identification 
number 
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Appendix C 


How to Configure Your System 


In many cases, there are installation-specific settings for 
MS-DOS that need to be configured at system startup. An 
example of this is a standard device driver, such as an 
on-line printer. 


The MS-DOS configuration file (CONFIG.SYS) lets you 
configure your system with little effort. With this file, you 
can add device drivers to your system at startup. The 
configuration file is simply an ASCII file that has certain 
commands for MS-DOS startup. The startup process is as 
follows: 


ae The disk boot sector is read. The boot sector con- 
tains enough code to read MS-DOS code and the 
installation’s BIOS (machine-dependent code). 


2. The MS-DOS code and BIOS are read. 
3. A variety of BIOS initializations are done. 


4. Asystem initialization routine reads CONFIG.SYS, if 
it exists, to perform a device installation and other 
user options. Its final task is to execute the command 
interpreter, which finishes startup. 


Changing the CONFIG.SYS File 


If there is not a CONFIG.SYS file on the MS-DOS disk, use 
the editor to create the file and save it in the root directory 
of the MS-DOS disk. 


The following is a list of commands for the CONFIG.SYS 
file: 

Buffers = number 

Sets the number of open files that will comprise the 


system list. It is installation-dependent. If the member is 
not set, use 10. 


Files = number 


Sets the number of open files that the XENIX-compatible f \ 
system calls can access. It is installation-dependent. If the 
number is not set, use 10.Device = filename. 


Installs the device driver in the file, which is specified by 
pathname, into the system list. (See below.) 


Break = [ONIOFF] 


Sets MS-DOS to check for the (CTRL) (C_) as input every 
time MS-DOS is called, if you specify ON. ON improves the 
ability to abort programs. OFF is the default. 


Shell = pathname 


Begins execution of the shell (the top-level command 
processor) from the file specified by pathname. 


A typical CONFIG.SYS file might look like this: 


Buffers = 10 om, 
Files = 10 — 
Device = \BIN\network.sys 

Break = ON 

Shell = A:\BIN\command.com A:\BIN /P 


Note here that the Buffers= and Files= parameters are 
set to 10. The system initialization routine will search for 
the file \BIN\ Network.sys to find the device that is being 
added to the system. This file is usually supplied on disk 
with your device. Make sure that you save the device 
file in the pathname that you specify with the Device = 
parameter. 


This configuration file also sets the MS-DOS command 

EXEC to the Command.com file located in A:\BIN. The 
A:\BIN tells Command.com where to look for itself when 

it needs to re-read from disk. The /P tells Command.com 

that it is the first program running on the system so that it on 
can process the MS-DOS EXIT command. 
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Appendix D 
ASCII and Scan Codes 


The following table lists the keys, in scan code order, and 
the ASCII codes generated by each (which depends on the 
shift status). The entries in the table are: 


SCAN CODE — a value in the range 01H-5AH (hexa- 
decimal) which uniquely describes which key is 
pressed. 


KEYBOARD LEGEND — the physical marking(s) on the 
key. If multiple markings exist, they are listed from top 
to bottom. 


NORMAL — the normal (unshifted) ASCII value (re- 
turned when only the indicated key is pressed). 


SHIFT — the shifted ASCII value (returned when (SHIFT 
is also pressed). 


CTRL — the control ASCII value (returned when TRL 
is also pressed). 


ALT — the alternate ASCII value (returned when is 
also pressed). 


¢ REMARK — any remarks or special functions. 


All numerical values in the table are expressed in hexa- 


decimal. Those values preceded by an “x” are extended 
ASCII codes (they are preceded by an ASCII NUL ( =00)). 


A marking of -- indicates that no ASCII code is generated. A 
marking of ** indicates that no ASCII code is generated 
and, instead, the special function described in the RE- 
MARK column is performed. 
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SCAN 
CODE 


00 
@1 
@2 
03 


04 
05 
06 
07 


08 
09 
A 
0B 


eC 
@D 
OE 
OF 


10 
11 
12 
13 


14 
15 
16 
17 


18 
19 
1A 
1B 


1c 
1D 
1E 
1F 


20 
21 
22 
23 


KEYBOARD 
LEGEND 


ESC 
! 


@ 


% 


«x & 


+_ 
+ 


BACKSPACE 


TAB 


-c<H -zwmeo 


“ADO 
ue 


1 
2 


NW BR OW 


ENTER 


TONG “FO 
& 


NORMAL 


(none / invalid scan code) 


1B 
31 
32 


33 
34 
35 
36 


37 
38 
39 
30 


2D 
3D 
08 

109 


71 
77 
65 
72 


74 
79 
75 
69 


OF 
70 
5B 
5D 


@D 
61 
73 


64 
66 
67 
68 


xOF 
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1E 


x8D 


REMARK 


(main keyboard) 
CONTROL MODE 


SCAN KEYBOARD 


CODE 


24 
25 
26 
27 


LEGEND 


<OXKN 


AZZ 


ALT 
SPACEBAR 
CAPS 

Fl 


F2 
F3 
F4 
F5 


F10 

NUM LOCK 
HOLD 

\7 


x48 


x4B 


x3C 
x3D 


x40 
x41 
x42 
x43 


x44 


** 


aR 


37 


x85 


x87 


x54 


x55 
x56 
x57 
x58 


x59 
x5SA 
x5B 
x5C 


x5D 


seo 


ee 


5C 
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2k 


x72 


sek 


20 


ak 


x5E 


XSF 
x60 
x61 
x62 


x63 
x64 
X65 
x66 


x67 


ak 


sek 


x93 


1k 


x46 


ae 


20 


2k 


x68 


x69 
x6A 
x6B 
x6C 


x6D 
x6E 
x6F 
x70 


x71 


sok 


oe 


(left) SHIFT 


(right) SHIFT 
PRINT SCREEN 
TOGGLE 


ALTERNATE MODE 


CAPS LOCK 


NUMBER LOCK 
FREEZE DISPLAY 
+ 


SCAN KEYBOARD ASCII 


CODE LEGEND NORMAL SHIFT CTRL ALT REMARK 

48 ~8 38 7E x94 ” + fo 

49 PG UP 9 39 x49 x84 om t+ ~ 

4A Y x50 x86 x96 x97 

4B | 4 34 7C x95 a t 

4C 5 35 - a + 

4D 6 36 - +t Hi 

4E ~~ x4D x88 x74 ae SMOOTH SCROLL 
TOGGLE 

4F END 1 31 x4F x75 * t 

50 2 32 60 x9A et t 

51 PG DN 3 33 x51 x76 ba + 

52 1) 30 x9B x9C = t 

53 DELETE x53 x8A x9D x9E 

54 BREAK x00 x00 r x00 MS-DOS BREAK 

(INT1BH) 

55 INSERT x52 x89 x9F xAO 

56 : 2E xAl xA4 xA5 (numeric keypad) on™ 

57 ENTER 0D @D @A x8F (numeric keypad) 

58 HOME x47 x4A x77 xA6 

59 Fll x98 xA2 xAC xB6 

5A F12 x99 xA3 xAD xB7 


+The @LT key provides a way to generate the ASCII codes of decimal numbers between 1 
and 255. Hold down (ALD while you type on the numeric keypad any decimal number 
between 1 and 255. When you release (ALT), the ASCII code of the number you typed is 
generated and displayed. 


Note: When the light is off, the NORMAL and SHIFT columns for the numeric 
keypad keys should be reversed. 
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Appendix E 
ASCII Character Codes 


The table in Appendix D listed the ASCII codes (in hexa- 
decimal) generated by each key. The table in this appen- 
dix lists the characters generated by those ASCII codes. 
(Note: All ASCII codes in this table are expressed in 
decimal form.) 


You can display the characters listed by doing either of the 
following: 


* Using the BASIC statement PRINT CHR$(code), where 
code is the ASCII code. 


* Pressing and, without releasing it, typing the ASCII 
code on the numeric keypad. 


For Codes 0-31, the table also lists the standard interpreta- 
tions. The interpretations are usually used for control 
functions or communications. 


Note: The BASIC program editor has its own special 
interpretation of some codes and may not display the 
character listed. 


ASCII 
Code 


000 
001 

002 
003 
004 
005 
006 
007 
008 
009 
010. 
011 

012 
013 
014 
015 
016 
017 
018 
019 
020 
021 

022 
023 
024 
025 
026 
027 
028 
029 
030 
031 


(beep) 

a 

(tab) 

(line feed) 
(home) 

(form feed) 
(carriage return) 


{prrrpess—t ras 


(cursor right) 
(cursor left) 
(cursor up) 
(cursor down) 
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Control 
Character 


NUL 
SOH 
STX 
ETX 
EOT 
ENQ 
ACK 
BEL 
BS 
HT 
LF 
VT 
FF 
CR 
SO 
SI 
DLE 
Dc1 
Dc2 
DC3 
Dc4 
NAK 
SYN 
ETB 
CAN 
EM 
SUB 
ESC 
FS 
GS 
RS 
US 


Character 


ASCII 
Code 


Character 


064 


(space) 


065 
066 
067 
068 
069 
070 
071 


034 


035 
036 
037 
038 


. 


072 
073 
074 
075 
076 
077 


078 
079 


080 
081 


082 


083 


050 
051 
052 
053 
054 
055 
056 


084 
085 
086 
087 


088 


089 
090 
091 
092 
093 
094 


nA 


057 
058 
059 
060 
061 
062 


095 


n. 


287 


ASCII 
Code 


096 
097 
098 
099 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 

112 
113 
114 
115 
116 
117 
118 
119 
120 
121 

122 
123 
124 
125 
126 
127 


Character 


zsaonroaQaoao»g - 


— 


yea a aie ere een RO es 
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@- O: o> OQ Wo @ @w: o> OD 


VHKma C OK: 


w 
a 


c’ ©) O/ 0: O> hy B Ms yp -- -» 


ASCII ASCII 


Code Character Code Character 
eee UL t———————CCW— awe Character 


160 


a 192 L 
161 if 193 4 
162 6 194 + 
163 u 195 F 
164 Ai 196 = 
165 N 197 oaks 
166 a 198 ie 
167 ° 199 lt 
168 é 200 & 
169 . 201 F 
170 rent 202 ak 
171 % 203 = 
172 % 204 Ik 
173 a4 205 = 
174 « 206 dt 
175 ») 207 + 
176 % 208 at 
177 4 209 = 
178 4 210 aes 
179 | 211 w 
180 4 212 = 
181 + 213 es 
182 + 214 r 
183 = 215 di 
184 5 216 + 
185 =| 217 4 
186 I 218 a 
187 = 219 g 
188 - 220 -_ 
189 4 221 | 
190 4 222 | 
191 A 223 = 
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Character 


rk rn A il > QB TO dG OAT AMA 1B R 


o 2 


a 
(blank ‘FF’) 


Index 


Addresses, Assigning 222 
Alignment 217 
Anonymous directory names 21-22 
Application program 7 
Exiting from 92 
Returning to 92 
Arguments 25 
ASCII codes 281-285 
ASCII files, Copying 64-74 


Background printing 122-125 
BACKUP 50-51 
Batch files 31-39 
Aborting execution 32 
Autoexec.bat 34-35 
Advice about 33 
Conditional execution of batch command (IF) 113-114 
Creating 31-32 
Displaying commands during execution (ECHO) 85-86 
Executing 32-33 
Including remarks in (REM) 32, 130 
Summary of batch file process 34 
Suspending execution 32, 120-121 
Reminders about 38-39 
Transferring control to a specific line (GOTO) 109-110 
Using replaceable parameters in 35-38 
Binary files, Copying 64-74 
BREAK 52 


Canonical frame 218 
CHDIR (CD) 53-55 
CHKDSK 56-59 
Classes 206 
CLS 60 
Combine types 217 
Common 219 
Stack 219 
Private 218 
Public 219 
COMMAND.COM 41 
Command 9, 23-26, 41-45, 103-104 
Aborting a command 26, 45 
Delimiters 26 
Editing a command 41-45 
Errors 268-275 
Executing one for several items (FOR) 103-104 
Parameters 25 
Piping commands 29 


Processor 41 
Quick reference list 276-278 


Syntax notation 47-48 : 
Template 41 f \. 
Types of commands 9, 23-24 

CON 13 

CONFIG.SYS 279-280 

Configuring the system 279-280 

Control character keys 45-46 

COMPDUPE 61-63 

COPY 64-68 

COPY/APPEND 69-71 

COPY/COMBINE 72-74 

CTTY 75 

Current directory 18-20 

Current drive 17-18 


Data, Sorting 143-144 

DATE 76-77 

DEBUG 229-263 
ASSEMBLE 235-237 
Commands 230 
COMPARE 238 
DUMP 239 ff | 
ENTER 240-241 : 
Error messages 263 
FILL 242 
GO 243-244 
HEX 245 
INPUT 246 
LOAD 247-248 
MOVE 249 
NAME 250-251 
OUTPUT 252 
Parameters 230 
QUIT 253 
REGISTER 254-256 
SEARCH 257 
Starting 229 
TRACE 258 
UNASSEMBLE 259-260 
WRITE 261-262 

DEL 87-88 

Delimiters 26 

Device 13, 75 


Changing I/O device 75 i, 
Errors 265-267 ake 
Names 13 

DIR 79-81 

Directory 9, 13-22, 53-59, 115-116, 135-136 
Changing (CHDIR) 19-20, 53-55 


Checking for errors (CHKDSK) 56-59 
Creating (MKDIR) 15-16, 115-116 
Current 18-20 
Home 20-21 
Names, Anonymous 21-22 
Removing (RMDIR) 17, 135-136 
Root 9 
Using 13-15 

Disk 56-59, 61-63, 79-84, 105-108, 111-112, 128-129, 195 
Checking for errors (CHKDSK) 56-59 
Comparing (COMPDUPE) 61-63 
Displaying information about (DIR) 79-81 
Duplicating (COMPDUPE, DISKCOPY) 61-62, 82-84 
Interleave factor 106, 112 
Labeling 105, 107, 112 
Preparing a floppy disk (FORMAT) 105-108 
Preparing a hard disk (HFORMAT) 111-112 
Recovering a flawed disk (RECOVER) 128-129 
Sector 105 
Skew 105 
Track 105 
Writing lines to disk 195 

DISKCOPY 82-84 
Copying a datadisk 83 
Copying a system disk 83 

Display 
See Screen 

Drive, Current 17-18 


ECHO 85-86 

Editing keys 42-45 
Deleting a character ((QELETE)) 42 
Deleting to a character ((F4)) 42 
Entering a line (CENTER) 43 
Inserting (GNSERT) 42 
Replacing the template ((F5)) 42 
Voiding a line (SQ) 42 

EDLIN 
See Line editor 

End-of-file (EOF) 64-74 

ERASE 87-88 
Using wild card with 87 

Error messages 265-275 

EXE2BIN 89-91 

Executable file, Converting to binary 89-91 

EXIT 92 

Extension 10-11 

External commands 9, 24, 66-67 
Telling MS-DOS where to find (PATH) 66, 118-119 
Transferring to another directory (COPY) 66-67 


FC Utility 93-99 

File 8, 69-74, 87-91, 93-102, 128-133, 145, 148-151, 154-155, 190-193 
Appending to (COPY/APPEND) 69-71 
Combining files (COPY/COMBINE) 72-74 
Comparison, byte-by-byte (FC) 93-99 
Comparison, line-by-line (FC) 93-99 
Converting executable to binary (EXE2BIN) 89-91 
Copying (COPY) 64-68 
Copying system files (SYS) 145 
Creating files (Line editor) 154-155 
Displaying contents (TYPE) 148-149 
Displaying information about (DIR) 79-81 
Editing (Line editor) 154 
Organization of the file system 8 
Paging through 186 
Recovering a flawed file (RECOVER) 128-129 
Removing (ERASE) 87-88 
Renaming (REN) 131-133 
Saving (Line editor) 155 
Searching for a string (FIND) 100-102, 190-193 
Verifying (VERIFY) 151 

Filename 10-11 
Wild cards 11-12 

Filespec 25 

Filters 28 
See also FIND, MORE, SORT 

FIND 28, 100-102 

FOR 103-104 

FORMAT 105-108 


GOTO 109-110 
Groups 205 


H 


Hard disk 48-51, 111-112, 134 
Backing up files to floppy disk (BACKUP) 50-51 
Entering commands for 48-49 
Preparing (HFORMAT) 111-112 
Restoring files to (RESTORE) 134 
Transferring system files to (HFORMAT) 111-112 
Home directory 20-21 


IF 113-114 

Input, Redirecting from file 27 
Interleave factor 106 

Internal commands 9, 23-24 

VO device, Changing (CTTY) 75 


os 


— 


Line editor 153-198 
Creating files 154-155 
Commands 169-195 
Editing existing files 154 
Editing keys 156-164 
Error messages 195-198 
Functions of 153 
Saving files 155 

Line editor commands 165-195 
Append Lines 169 
Copy Lines 170-172 
Delete Lines 173-175 
Edit Lines 176-177 
End Edit 178 
Insert Lines 179-181 
List Lines 182-184 
Move Lines 185 
Page 186 
Quit Edit 187 
Replace String 188-189 
Search Text 190-193 
Transfer Lines 194 
Write Lines 195 

Linker 199-223 
Canonical frame 218 
Classes 206 
Combine types 217 
Groups 205 
Relocation fixups 222 
Response file 213-214 
Sample session 214-215 
Segments 205 
Starting 211-212 
Switches 209-211 

List file 201 

Long relocation fixups 224 

LST 13 


MKDIR 15-16, 115-116 
MORE 28, 117 
MS-LINK 

See Linker 


N 


Near self-relative relocation fixups 223 
Near segment-relative relocation fixups 223-224 


Output 27-28, 97 
Appending to file 28 
Redirecting to file 27 
Redirecting to printer 97 


Parameters 25 
Setting for later use (SET) 137-140 
Jsing more than 10 replaceable parameters (SHIFT) 141-142 
PATH 118-119 
Pathname 12-13 
PAUSE 120-121 
Piping 29 
PRINT 122-125 
Printing 45, 122-125 
All video output 45 
Background 122-125 
Current display 45 
Private combine 214 
Programs, Linking 
See Linker 
PROMPT 126-127 
Public combine 215 


RECOVER 128-129 


Long 224 
Near segment-relative 223-224 
Near self-relative 223 
Short 223 
REM 130 
REN 131-133 
Replaceable parameters, Using more than 10 (SHIFT) 141-142 
RESTORE 134 
RMDIR 135-136 
Root directory 9 
Run file 200 


Scan codes 281 
Screen 45, 60, 117 
Clearing (CLS) 60 
Displaying one at a time (MORE) 117 
Printing current display (GHIFT) @RIND) 45 
Suspending scrolling (@TRD CS)) 45 
Sector 105 
Segment 205 
Segment address 221 


SET 137-140 

SHIFT 141-142 

Short relocation fixups 223 

Skew 106 

SORT 28, 143-144 

Source files, Comparing 98 

Stack combine 215 

String, Replacing 188-189 

String, Searching a file for 100-102 
SYS 145 

System prompt, Changing 7, 126-127 
Switches 25 


T 


Template 41 

Temporary file (VM.TMP) 202-203 
TIME 146-147 

Track 105 

TYPE 148-149 


VERIFY 151 

VERSION 150 

VM.TMP (Temporary file) 202-203 
VOL 152 


Ww 


- Wild card filenames 11-12 
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